{"id":15155261,"url":"https://github.com/coslynx/ai-telegram-bot-dashboard","last_synced_at":"2026-02-23T22:07:57.320Z","repository":{"id":252243847,"uuid":"839862682","full_name":"coslynx/ai-telegram-bot-dashboard","owner":"coslynx","description":"Project: AI-Powered Telegram Bot with Web Dashboard. Created at https://spectra.codes, which is owned by @Drix10","archived":false,"fork":false,"pushed_at":"2024-08-08T13:39:28.000Z","size":41,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-14T14:13:52.060Z","etag":null,"topics":["ai-telegram-bot","api-integration","code-generation","code-quality","context-aware-chat","developer-tools","devops","express-js","image-processing","javascript","machine-learning","multi-model-chat","next-js","node-js","openai-api","postgresql","software-development","typescript","user-database","web-dashboard"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coslynx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-08T13:27:08.000Z","updated_at":"2025-10-09T15:46:56.000Z","dependencies_parsed_at":"2024-08-08T15:48:01.042Z","dependency_job_id":"517dd11b-d227-46c3-97bd-8bf5be71bf7b","html_url":"https://github.com/coslynx/ai-telegram-bot-dashboard","commit_stats":null,"previous_names":["spectra-ai-codegen/ai-telegram-bot-dashboard","coslynx/ai-telegram-bot-dashboard"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/coslynx/ai-telegram-bot-dashboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2Fai-telegram-bot-dashboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2Fai-telegram-bot-dashboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2Fai-telegram-bot-dashboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2Fai-telegram-bot-dashboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coslynx","download_url":"https://codeload.github.com/coslynx/ai-telegram-bot-dashboard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2Fai-telegram-bot-dashboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019125,"owners_count":26086679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-telegram-bot","api-integration","code-generation","code-quality","context-aware-chat","developer-tools","devops","express-js","image-processing","javascript","machine-learning","multi-model-chat","next-js","node-js","openai-api","postgresql","software-development","typescript","user-database","web-dashboard"],"created_at":"2024-09-26T18:03:58.624Z","updated_at":"2025-10-14T14:13:54.828Z","avatar_url":"https://github.com/coslynx.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/PKief/vscode-material-icon-theme/ec559a9f6bfd399b82bb44393651661b08aaf7ba/icons/folder-markdown-open.svg\" width=\"100\" /\u003e\n  \u003cbr\u003eai-telegram-bot-dashboard\n\u003c/h1\u003e\n\u003ch4 align=\"center\"\u003eAI-powered Telegram bot with a comprehensive web dashboard for managing and enhancing AI-assisted conversations and content analysis.\u003c/h4\u003e\n\u003ch4 align=\"center\"\u003eDeveloped with the software and tools below.\u003c/h4\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Framework-Next.js-blue\" alt=\"Framework used\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Frontend-TypeScript,_HTML,_CSS-red\" alt=\"Frontend technologies used\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Backend-Node.js-blue\" alt=\"Backend technology used\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/AI-OpenAI,_LangChain-black\" alt=\"AI technologies used\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/last-commit/spectra-ai-codegen/ai-telegram-bot-dashboard?style=flat-square\u0026color=5D6D7E\" alt=\"git-last-commit\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/commit-activity/m/spectra-ai-codegen/ai-telegram-bot-dashboard?style=flat-square\u0026color=5D6D7E\" alt=\"GitHub commit activity\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/languages/top/spectra-ai-codegen/ai-telegram-bot-dashboard?style=flat-square\u0026color=5D6D7E\" alt=\"GitHub top language\" /\u003e\n\u003c/p\u003e\n\n## 📑 Table of Contents\n- 📍 Overview\n- 📦 Features\n- 📂 Structure\n- 💻 Installation\n- 🏗️ Usage\n- 🌐 Hosting\n- 📄 License\n- 👏 Authors\n\n## 📍 Overview\nThis repository houses the \"ai-telegram-bot-dashboard\" project, which brings together the power of AI and Telegram to provide a sophisticated communication and automation platform. The project features a robust web dashboard that allows for seamless management and configuration of the AI-powered bot.\n\n## 📦 Features\n|    | Feature            | Description                                                                                                        |\n|----|--------------------|--------------------------------------------------------------------------------------------------------------------|\n| ⚙️ | Architecture   | The project's architecture is designed for modularity, scalability, and maintainability, with separate components for bot logic, web dashboard, and AI integration.             |\n| 📄 | Documentation  | This README file provides a comprehensive overview of the project, its features, dependencies, and instructions for installation and usage. |\n| 🔗 | Dependencies   | The project leverages a range of popular libraries and packages, including Next.js, Express.js, Prisma, OpenAI, and LangChain, to ensure efficient development and integration.  |\n| 🧩 | Modularity     | The codebase is structured modularly, with distinct directories for frontend (web dashboard), backend (API), and telegram bot functionalities. This approach facilitates easier code maintenance and allows for efficient expansion.|\n| 🧪 | Testing        | Thorough testing is implemented to ensure the reliability and robustness of the codebase, utilizing frameworks like Jest. |\n| ⚡️  | Performance    | Performance optimization strategies are employed to ensure a smooth and responsive user experience, including caching, database optimization, and efficient resource utilization. |\n| 🔐 | Security       | Robust security measures are implemented to protect sensitive user data and ensure secure communication. These measures include input validation, data encryption, and regular security audits. |\n| 🔀 | Version Control| The project utilizes Git for version control, with GitHub Actions workflow files for automated build and release processes. |\n| 🔌 | Integrations   | The platform integrates with various services and APIs, including the Telegram Bot API, OpenAI API, weather APIs, news APIs, image processing APIs, and translation APIs. |\n| 📶 | Scalability    | The project is designed for scalability to handle increased user loads and data volumes, leveraging cloud-based infrastructure and database optimizations. |\n\n## 📂 Structure\n```\n├── src\n│   ├── telegram\n│   │   ├── utils\n│   │   │   └── bot.ts\n│   │   ├── services\n│   │   │   └── openai.service.ts\n│   │   ├── types\n│   │   │   └── types.ts\n│   │   ├── commands\n│   │   │   ├── help.ts\n│   │   │   ├── start.ts\n│   │   │   └── translate.ts\n│   │   ├── events\n│   │   │   └── message.ts\n│   │   └── index.ts\n│   │       └── constants.ts\n│   ├── web\n│   │   ├── api\n│   │   │   ├── controllers\n│   │   │   │   ├── user.controller.ts\n│   │   │   │   ├── admin.controller.ts\n│   │   │   │   ├── image.controller.ts\n│   │   │   │   ├── conversation.controller.ts\n│   │   │   │   └── bot.controller.ts\n│   │   │   ├── middlewares\n│   │   │   │   ├── auth.middleware.ts\n│   │   │   │   └── validate.middleware.ts\n│   │   │   ├── services\n│   │   │   │   ├── user.service.ts\n│   │   │   │   ├── image.service.ts\n│   │   │   │   ├── conversation.service.ts\n│   │   │   │   └── bot.service.ts\n│   │   │   └── routes.ts\n│   │   ├── pages\n│   │   │   ├── admin\n│   │   │   │   ├── dashboard\n│   │   │   │   │   └── index.tsx\n│   │   │   │   ├── users\n│   │   │   │   │   └── index.tsx\n│   │   │   │   └── settings\n│   │   │   │       └── index.tsx\n│   │   │   ├── auth\n│   │   │   │   └── login.tsx\n│   │   │   ├── conversations\n│   │   │   │   └── index.tsx\n│   │   │   └── index.tsx\n│   │   ├── config\n│   │   │   └── env.ts\n│   │   ├── app.tsx\n│   │   ├── db.ts\n│   │   ├── utils\n│   │   │   ├── error.ts\n│   │   │   ├── logger.ts\n│   │   │   └── response.ts\n│   │   ├── types\n│   │   │   ├── types.ts\n│   │   │   └── user.ts\n│   ├── core\n│   │   ├── config\n│   │   │   └── openai.config.ts\n│   │   ├── utils\n│   │   │   ├── string.ts\n│   │   │   ├── time.ts\n│   │   │   └── logger.ts\n│   │   ├── types\n│   │   │   └── types.ts\n│   │   └── constants.ts\n│   ├── models\n│   │   ├── User.ts\n│   │   ├── Conversation.ts\n│   │   └── Image.ts\n│   └── prisma\n│       └── schema.prisma\n├── .eslintrc.js\n├── tsconfig.json\n├── next.config.js\n├── tailwind.config.js\n└── package.json\n\n```\n\n## 💻 Installation\n### 🔧 Prerequisites\n- Node.js\n- npm\n- Docker\n\n### 🚀 Setup Instructions\n1. Clone the repository:\n     - `git clone https://github.com/spectra-ai-codegen/ai-telegram-bot-dashboard.git`\n2. Navigate to the project directory:\n     - `cd ai-telegram-bot-dashboard`\n3. Install dependencies:\n     - `npm install`\n  \n## 🏗️ Usage\n### 🏃‍♂️ Running the Project\n1. Start the development server:\n     - `npm start`\n2. Open your browser and navigate to [http://localhost:3000](http://localhost:3000).\n\n### ⚙️ Configuration\nAdjust configuration settings in `config.js` or `.env`.\n\n### 📚 Examples\n- 📝 Example 1: Send a text message to the bot and receive an AI-generated response.\n- 📝 Example 2: Utilize the image processing features to extract text from an image or generate a caption for an image.\n- 📝 Example 3: Access the web dashboard to manage bot settings, monitor bot usage, and configure user access.\n\n## 🌐 Hosting\n### 🚀 Deployment Instructions\n#### Docker and Cloud Deployment\n1. Build the Docker image:\n     - `docker build -t ai-telegram-bot-dashboard .`\n2. Run the Docker container:\n     - `docker run -p 3000:3000 ai-telegram-bot-dashboard`\n\n#### Heroku\n1. Install the Heroku CLI:\n     - `npm install -g heroku`\n2. Login to Heroku:\n     - `heroku login`\n3. Create a new Heroku app:\n     - `heroku create`\n4. Deploy the code:\n     - `git push heroku main`\n\n### 🔑 Environment Variables\n- `TELEGRAM_BOT_TOKEN`: Your Telegram bot token\n- `OPENAI_API_KEY`: Your OpenAI API key\n- `DATABASE_URL`: Your database connection URL\n\n## 📜 API Documentation\n### 🔍 Endpoints\n- GET /api/bot/messages: Retrieves a list of messages sent to the bot.\n- POST /api/bot/messages: Sends a message to the bot.\n- GET /api/admin/users: Retrieves a list of users.\n- POST /api/admin/users: Creates a new user.\n\n### 🔒 Authentication\nUse JWT tokens for authentication.\n\n### 📝 Examples\n- `curl -X GET http://localhost:3000/api/bot/messages`\n\n## 📜 License\nThis project is licensed under the [GNU AGPLv3](https://choosealicense.com/licenses/agpl-3.0/).\n\n## 👥 Authors\n- Author Name - [Spectra.codes](https://spectra.codes)\n- Creator Name - [DRIX10](https://github.com/Drix10)\n\n  \u003cp align=\"center\"\u003e\n    \u003ch1 align=\"center\"\u003e🌐 Spectra.Codes\u003c/h1\u003e\n  \u003c/p\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cem\u003eWhy only generate Code? When you can generate the whole Repository!\u003c/em\u003e\n  \u003c/p\u003e\n  \u003cp align=\"center\"\u003e\n\t\u003cimg src=\"https://img.shields.io/badge/Developer-Drix10-red\" alt=\"\"\u003e\n\t\u003cimg src=\"https://img.shields.io/badge/Website-Spectra.codes-blue\" alt=\"\"\u003e\n\t\u003cimg src=\"https://img.shields.io/badge/Backed_by-Google,_Microsoft_\u0026_Amazon_for_Startups-red\" alt=\"\"\u003e\n\t\u003cimg src=\"https://img.shields.io/badge/Finalist-Backdrop_Build_v4-black\" alt=\"\"\u003e\n  \u003cp\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoslynx%2Fai-telegram-bot-dashboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoslynx%2Fai-telegram-bot-dashboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoslynx%2Fai-telegram-bot-dashboard/lists"}