{"id":30699683,"url":"https://github.com/johndev19/lumina-bot","last_synced_at":"2025-09-02T11:12:17.310Z","repository":{"id":274302791,"uuid":"922506442","full_name":"JohnDev19/Lumina-Bot","owner":"JohnDev19","description":"Lumina is a Telegram bot assistant designed to provide intelligent interactions, automated responses, and versatile communication tools.","archived":false,"fork":false,"pushed_at":"2025-01-26T12:10:29.000Z","size":570,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-26T13:22:15.269Z","etag":null,"topics":["assistant","bot","chatbot","telegram","telegram-chatbot"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JohnDev19.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2025-01-26T12:01:51.000Z","updated_at":"2025-01-26T12:20:54.000Z","dependencies_parsed_at":"2025-01-26T13:22:20.152Z","dependency_job_id":"bc470a13-c191-41f4-b0db-71ddcb310f35","html_url":"https://github.com/JohnDev19/Lumina-Bot","commit_stats":null,"previous_names":["johndev19/lumina-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/JohnDev19/Lumina-Bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnDev19%2FLumina-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnDev19%2FLumina-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnDev19%2FLumina-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnDev19%2FLumina-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JohnDev19","download_url":"https://codeload.github.com/JohnDev19/Lumina-Bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnDev19%2FLumina-Bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273273249,"owners_count":25076130,"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-09-02T02:00:09.530Z","response_time":77,"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":["assistant","bot","chatbot","telegram","telegram-chatbot"],"created_at":"2025-09-02T11:12:13.857Z","updated_at":"2025-09-02T11:12:17.303Z","avatar_url":"https://github.com/JohnDev19.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lumina Bot\n\n![Lumina Bot Logo](https://i.ibb.co/3YN5ggW/lumina.jpg)\n![Lumina](https://i.ibb.co/DCxTK2q/IMG-20250126-111106.jpg)\n\nLumina is a Telegram bot assistant designed to provide intelligent interactions, automated responses, and versatile communication tools.\n\n- Join here: https://t.me/+K3SoAlqE9_RjMzE1\n\n## 🤖 Key Features\n\n### Communication\n- **AI-Powered Responses**: Intelligent and context-aware conversations\n- **Automated Greetings**: Smart, personalized welcome messages\n- **Voice Generation**: AI-generated voice responses with `/Lumina` command\n- **ChatGPT Integration**: Direct access to advanced AI conversations with `/ChatGPT` command\n\n## 🔐 Administrative Requirements\n\n### Group Integration\n- **Admin Privileges Required**: \n  - Lumina requires admin privileges to function fully in group chats\n  - Without admin rights, bot functionality will be limited\n\n### Owner Management\n- **Exclusive Owner Commands**\n  - Specific commands are restricted to bot owner\n  - Owner identified by `OWNER_ID` in environment configuration\n  - Example of owner-only command structure:\n    ```javascript\n    module.exports = {\n      name: 'sampleName',\n      description: 'sampleDescription',\n      owner: true,\n      execute: async (bot, msg, args, db) =\u003e {\n      }\n    }\n    ```\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Node.js (v14.0.0 or higher)\n- npm (Node Package Manager)\n- Telegram account\n\n### Configuration\n\n1. **Environment Variables**:\n   Create a `.env` file with the following configurations:\n\n   ```plaintext\n   TELEGRAM_BOT_TOKEN=your_telegram_bot_token\n   OWNER_ID=your_telegram_user_id\n   URL=https://your_deployment_url\n   UPTIME_URL=your_uptime_monitoring_url\n   ```\n\n   **- Obtaining Bot Token**:\n   \n   ![botFather](https://i.ibb.co/pJjrhBy/IMG-20250126-103529.jpg)\n   \n   1. Visit BotFather on Telegram\n   2. Use the /newbot command to create a new bot\n   3. Choose a name and username for your bot\n   4. BotFather will provide you with a bot token\n  \n   **- Obtaining ID**:\n   \n   ![id](https://i.ibb.co/fvZ8Cxw/IMG-20250126-102430.jpg)\n   \n   1. **Search for a User ID Bot**: You can search for a bot like @userinfobot on Telegram.\n   2. **Start the Bot**: Click on the bot and press the \"Start\" button.\n   3. **Get Your User ID in .env**: The bot will respond with your user ID and other information.\n   4. **Setting up your Owner ID**:\n   `OWNER_ID=your_telegram_user_id`\n  \n    **- Webhook Configuration**\n   \n   1. The bot uses a webhook for receiving updates\n   2. Set the URL and PORT in the .env file\n   3. Ensure your hosting platform supports webhooks\n   \n\n3. **Installation**:\n   ```bash\n   npm install\n   ```\n\n4. **Run the Bot**:\n   ```bash\n   node index.js\n   ```\n\n## Deploying Lumina (Render)\n- [Read more here](DEPLOYMENT.md)\n\n## 📜 Command Structure\n\nLumina's commands follow a standardized structure:\n\n```javascript\nmodule.exports = {\n  name: 'commandName', // Unique command identifier\n  description: 'Command purpose', // Brief description of the command\n  owner: false, // Optional: Restrict to bot owner\n  execute: async (bot, msg, args) =\u003e {\n    // Command implementation\n  }\n};\n```\n\n### Command Properties\n- `name`: The trigger for the command (e.g., 'fact')\n- `description`: Explains what the command does\n- `owner`: (Optional) Boolean to restrict command to bot owner\n- `execute`: Async function containing the command's logic\n  - `bot`: Telegram bot instance\n  - `msg`: Message object\n  - `args`: Optional command arguments\n\n## 🛠 Core Handlers\n\n- **autoReactHandler**\n- **automatedResponses**\n- **commandHandler** \n- **eventReminder**\n- **groupManager** \n- **moderationTools**\n- **ownerHandler**\n\n## 🛡️ Database\n\n1. Uses a simple JSON-based database system\n2. Stores user data, group information, and game states\n3. Located in the utils/database.js file\n\n##  Customization\n\n1. Easily add new commands by creating files in the commands directory\n2. Modify existing command behavior in their respective files\n3. Customize welcome/goodbye messages and images in the groupManager.js file\n\n## 🔧 Customization\n\nLumina's behavior can be customized through:\n- Handler configurations\n- Environment variable settings\n- Custom command implementations\n\n## 📜 Commands\n\n### Standard Commands\n- `/start`: Initialize bot interaction\n- `/help`: Display available commands\n- `/Lumina`: Trigger AI-powered response with voice generation\n- `/ChatGPT`: Direct access to ChatGPT conversation\n\n### Owner Commands\n- `/clearcache`: Clear bot's internal cache\n- `/clear`: Clear all messages except confirmation\n- `managegroups`: Manage groups: list, leave, or set auto-leave\n\n## 🤝 Contributing\n\nContributions are welcome! Please submit pull requests or open issues for feature suggestions and improvements.\n\n## 📄 License\n\nMIT License - See [LICENSE](LICENSE) for details\n\n## 💬 Support\n\nEncounter issues? Open a GitHub issue or contact support through Telegram.\n\n---\n\nLumina: Your Intelligent Telegram Companion 🌟\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohndev19%2Flumina-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohndev19%2Flumina-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohndev19%2Flumina-bot/lists"}