🏦 Complete Financial Integration Solution - A comprehensive multi-language ecosystem with C# (.NET 8) and Python implementations for SimpleFIN banking integration through Telegram Bot, Web API, and WebApp interfaces.
A dual-language implementation of SimpleFIN financial accounts integration with Telegram. Choose between C# (.NET 8) or Python implementations, both featuring secure configuration, real-time financial data access, and modern web interfaces.
- Enterprise-grade .NET 8 console application and ASP.NET Core API
- Advanced Configuration with appsettings.json and environment variables
- VS Code Integration with complete development environment
- GitHub Actions CI/CD for automated building and testing
📂 Location: /csharp | 📖 Documentation: C# README
- Modern async/await Python implementation with FastAPI
- Type Safety with full type hints and Pydantic models
- Auto-Documentation with FastAPI's OpenAPI integration
- Flexible Deployment options for containers and cloud platforms
📂 Location: /python | 📖 Documentation: Python README
| Feature | C# (.NET 8) | Python |
|---|---|---|
| Performance | ⭐⭐⭐⭐⭐ Compiled, very fast | ⭐⭐⭐⭐ Fast with async/await |
| Memory Usage | ⭐⭐⭐⭐ Efficient | ⭐⭐⭐ Moderate |
| Development Speed | ⭐⭐⭐ Structured, enterprise | ⭐⭐⭐⭐⭐ Rapid prototyping |
| Deployment | ⭐⭐⭐⭐⭐ Single executable | ⭐⭐⭐ Runtime required |
| Documentation | ⭐⭐⭐⭐ XML docs + IntelliSense | ⭐⭐⭐⭐⭐ Auto-generated API docs |
| Type Safety | ⭐⭐⭐⭐⭐ Compile-time checking | ⭐⭐⭐⭐ Runtime with type hints |
| Ecosystem | ⭐⭐⭐⭐ .NET ecosystem | ⭐⭐⭐⭐⭐ Vast Python libraries |
/startand/help- Interactive command guidance/add- Secure bank connection via SimpleFIN tokens/accountsand/refresh- Real-time account data with balance information/remove- Secure bank connection removal/web- Launch integrated WebApp interface
GET /api/accounts?user_id={id}- Retrieve user's bank connections- CORS enabled for cross-origin requests
- Error handling with structured responses
- Health checks and monitoring endpoints
- Telegram WebApp API integration with native theming
- Responsive design for mobile and desktop
- Real-time data synchronization with bot and API
- Enhanced UX with loading states and error handling
- Multi-environment support (Development/Production)
- Environment variables for secure production deployment
- Validation with helpful error messages for developers
- Flexible settings for different deployment scenarios
SimpleFinTelegramBot/
├── 📁 csharp/ # C# (.NET 8) Implementation
│ ├── SimpleFinBot/ # Console Bot Application
│ ├── SimpleFinWebApi/ # ASP.NET Core API
│ ├── SimpleFinWebApp/ # Static WebApp
│ ├── .github/workflows/ # CI/CD Pipeline
│ └── README.md # C# Documentation
├── 📁 python/ # Python Implementation
│ ├── SimpleFinBot/ # Async Python Bot
│ ├── SimpleFinWebApi/ # FastAPI Backend
│ ├── SimpleFinWebApp/ # Enhanced WebApp
│ └── README.md # Python Documentation
├── README.md # This file
├── DESCRIPTION.md # Project overview
└── GITHUB_DESCRIPTION.md # Repository metadata
cd csharp
dotnet restore
# Configure bot token in appsettings.json or environment variables
dotnet run --project SimpleFinWebApi # Terminal 1
dotnet run --project SimpleFinBot # Terminal 2cd python/SimpleFinBot
pip install -r requirements.txt
# Configure bot token in config.json or environment variables
cd ../SimpleFinWebApi && pip install -r requirements.txt
python api.py # Terminal 1
cd ../SimpleFinBot && python bot.py # Terminal 2Both implementations include:
- ✅ Secure token management with environment variable support
- ✅ Input validation and sanitization
- ✅ Parameterized database queries preventing SQL injection
- ✅ CORS configuration for API security
- ✅ Error handling with user-friendly messages
- ✅ Configuration validation with startup checks
- 🔷 C# Setup Guide - Complete .NET 8 setup instructions
- 🐍 Python Setup Guide - Python installation and configuration
- ⚙️ C# Configuration - Advanced C# configuration
- ⚙️ Python Configuration - Python configuration guide
- 📖 Project Overview - Architecture and design decisions
- 🏷️ Repository Info - GitHub metadata and tags
- Setup: Choose your preferred implementation (C# or Python)
- Configure: Set up your Telegram bot token via @BotFather
- Deploy: Run both the API server and bot application
- Connect: Start a chat with your bot and use
/addto connect banks - Access: Use bot commands or the WebApp interface to view account data
- VS Code: Complete development environment with tasks and debugging
- GitHub Actions: Automated CI/CD pipeline for testing and building
- IntelliSense: Full IDE support with compile-time error checking
- FastAPI Docs: Automatic API documentation at
/docs - Type Hints: Full type safety with runtime validation
- Hot Reload: Development server with auto-restart on changes
- Choose your preferred implementation (C# or Python)
- Fork the repository
- Create a feature branch
- Follow the coding standards for your chosen language
- Submit a pull request with tests
This project serves as a comprehensive template for SimpleFIN integration with Telegram bots in both C# and Python.
🔷 Choose C# for enterprise applications with high performance requirements
🐍 Choose Python for rapid development and extensive ecosystem integration
Both implementations provide identical functionality with language-specific optimizations!