BotU

A no-code Telegram bot builder platform with AI-powered assistance

---

✨ Features

Feature	Description
🤖 Bot Builder	Create and configure Telegram bots visually through a web dashboard
🎨 Bot Appearance	Customize bot name, avatar, colors, and description
💬 Command Builder	Define custom commands with responses, permissions, and activation toggles
🤖 AI Integration	Google Gemini-powered AI assistant and bot intelligence
📊 Analytics Dashboard	Real-time bot statistics, activity feed, and usage trends
🔐 Authentication	JWT-based user registration and login system
🌐 Bilingual	Full English and Persian (Farsi) language support with RTL
⚙️ Settings	Profile management, password change, 2FA, API keys
🔔 Notifications	Email and in-app notification preferences
🧩 Help Center	FAQ, command reference, troubleshooting, and support

---

🚀 Installation

Prerequisites

• Node.js v18+ (for frontend)
• Python 3.8+ with pip (for backend)
• Google Gemini API key (for AI features)

Frontend Setup

git clone https://github.com/AmirabbasRouintan/BotU.git
cd BotU
npm install
cp .env.example .env
npm run dev

The frontend runs on http://localhost:5173.

Backend Setup

cd Backend/server
pip install -r requirements.txt
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver

The backend API runs on http://localhost:8000.

Environment Variables

Create a .env file in the root directory:

VITE_GEMINI_API_KEY=your_gemini_api_key_here
VITE_API_URL=http://localhost:8000
TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here
NODE_ENV=development

---

🧠 Tech Stack

Layer	Technology
Frontend	React 19, TypeScript, Vite 7, Tailwind CSS 4
UI Components	shadcn/ui, Radix primitives, Lucide Icons, Framer Motion, GSAP
Backend	Django 4.2, Django REST Framework 3.14
Authentication	JWT (djangorestframework-simplejwt)
Database	SQLite
AI	Google Gemini API
Charts	Recharts
3D Graphics	React Three Fiber, Three.js

---

📁 Project Structure

BotU/
├── src/                    # React frontend source
│   ├── components/         # UI components (shadcn/ui + custom)
│   ├── pages/              # Application pages and dashboard tabs
│   ├── contexts/           # Auth, Language, Animation contexts
│   ├── hooks/              # Custom React hooks
│   └── lib/                # Utilities, translations, API helpers
├── Backend/server/         # Django backend
│   ├── core/               # Django settings, URLs, WSGI/ASGI
│   └── user/               # User auth, bot/command models, API views
├── public/                 # Static assets, Netlify config
├── package.json
└── vite.config.ts

---

🔌 API Endpoints

Endpoint	Method	Description
/auth/register/	POST	User registration
/auth/login/	POST	User login (returns JWT)
/auth/bots/	GET	List user's bots
/auth/update_gemini_api_key/	POST	Save Gemini API key
/auth/update_botfuther_tokens/	POST	Save BotFather tokens
/auth/ai/generate-content/	POST	Gemini AI chat proxy

---

📄 License

This project is MIT licensed.

---

⭐ If you found this project useful, please give it a star!

It took a lot of time and effort to build this project — your support means a lot ❤️