SmartFin is a cutting-edge AI-driven financial management platform enhanced with Hedera Hashgraph
- 🔁 Instant HBAR Transfers: Send HBAR tokens to any customer in your database directly from Telegram.
- 🎁 Automated Airdrops: Schedule or trigger token distributions to user segments or your entire customer base.
- 🎉 Custom Gifting: Create personalized token gifts to thank or incentivize individual customers.
- ⚡ Micro-fee Efficiency: Leverage Hedera’s low transaction fees for cost-effective micropayments.
- 📊 Real-Time Tracking: Monitor incomes, expenses, and transaction flows with live dashboards.
- 🤖 Smart Recommendations: Receive AI-powered suggestions for budgeting, expense reduction, and growth strategies.
- 📈 Custom Reports: Generate downloadable analytics and visualizations for stakeholders.
Interact with @Finnebulabot on Telegram for a fully conversational financial experience:
- 💬 Chat Commands: Intuitive commands to manage tokens, check balances, and review history.
- 🔔 Notifications: Automated alerts for incoming payments, upcoming airdrops, and low balances.
🔗 Launch the bot: @Finnebulabot
🎥 Watch Demo: SmartFin Hedera Bot in Action
[User via Telegram] <--> [Finnebulabot Service (NestJS)] <--> [SmartFin API (Next.js)]
| |
| --> [Hedera Hashgraph Network]
| --> [MongoDB Database]
|
--> [AI Insights Engine (Node.js/Python)]
- Finnebulabot Service: Receives and processes Telegram commands, validates user sessions, and routes requests to SmartFin API.
- SmartFin API: Core backend in Next.js handling business logic, AI integrations, and Hedera SDK interactions.
- Hedera Network: Executes token operations—transfers, airdrops, token minting via Hedera Token Service.
- MongoDB: Stores user profiles, transaction logs, bot settings, and AI-generated insights.
| Layer | Technology |
|---|---|
| Frontend | Next.js, React, Tailwind CSS |
| Backend API | Next.js (API Routes), Node.js |
| Database | MongoDB |
| Authentication | Firebase |
| AI Insights | OpenAI API, Germini Model |
| Hedera Integration | Hedera JavaScript SDK |
| Bot Framework | NestJS,granny |
| Charts & Reports | Chart.js |
- Node.js v14 or above
- MongoDB instance (local or Atlas)
- Hedera Account: Operator ID & Private Key
- Telegram Bot: Token from BotFather
-
Clone repository:
git clone https://github.com/Ekenesamuel8/smartfin.git cd smartfin -
Install dependencies:
npm install
-
Environment variables: Create a
.envfile in the project root with:MONGODB_URI=<your_mongodb_uri> NEXTAUTH_SECRET=<your_nextauth_secret> OPENAI_API_KEY=<your_openai_api_key> HEDERA_OPERATOR_ID=<your_hedera_account_id> HEDERA_OPERATOR_KEY=<your_hedera_private_key> TELEGRAM_BOT_TOKEN=<your_telegram_bot_token> GOOGLE_API_KEY=<your_google_api_key>
-
Start SmartFin API & Web:
npm run dev
-
Launch Telegram Bot Service:
cd bot npm install npm run test-telegram -
Interact with SmartFin: Open Telegram and chat with @Finnebulabot.
smartfin/
├── pages/ # Next.js web app routes and pages
├── components/ # React UI components
├── lib/ # Integration helpers (Hedera, Telegram)
├── ai/ # AI insights engine (optional Python services)
├── prisma/ # Prisma schema & migrations
├── public/ # Static assets (images, icons)
├── styles/ # Tailwind CSS configuration
├── scripts/ # Utility scripts (migrations, seeds)
├── .env.example # Example environment variables
├── next.config.js
├── package.json
└── README.md
- Okoye Emmanuel Obiajulu (Obiajulu-gif)
- Ekene Samuel Chinwendu (Ekenesamuel8)
- Okeoma Amaobi (OkeyAmy)
Contributions welcome! Fork the repo, open a pull request, and join us in revolutionizing financial automation.
Empower your business with AI, Hedera, and Telegram — SmartFin makes finance seamless!