Skip to content

Child-Coder/ChildBotHost

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

16 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ChildBotHost - Telegram Bot Hosting Platform

BotAlto Logo

ChildBotHost is an open-source platform for hosting and managing Telegram bots with a user-friendly dashboard. It allows you to create, manage, and deploy multiple Telegram bots from a single interface, complete with custom command creation and real-time control.

Features

  • πŸš€ Multi-Bot Management: Host and control multiple Telegram bots simultaneously
  • πŸ’» Web Dashboard: Intuitive interface for managing all aspects of your bots
  • ⌨️ Custom Commands: Create and edit bot commands with JavaScript code
  • ⚑ Real-time Control: Start/stop bots instantly from the dashboard
  • πŸ“Š Command Preview: See your command code directly in the dashboard
  • πŸ”’ Simple Authentication: Uses Telegram bot tokens for secure access
  • πŸ› οΈ Developer Friendly: Write custom bot logic with JavaScript

Installation

  1. Clone the repository:

    git clone https://github.com/Child-Coder/ChildBitHost
    cd ChildBitHost
  2. Install dependencies:

    npm install
  3. [OPTIONAL] Create a .env file with your configuration:

    PORT=3000
    # Add other environment variables as needed
  4. Start the server:

    node Backend/server.js
  5. Access the dashboard at http://localhost:3000

Usage Guide

πŸš€ Creating Commands

  1. Open the Commands card for your bot
  2. Enter command name (omit /)
  3. Paste JavaScript code (Telegraf context)
  4. Hit Save β†’ instant hot-reload

πŸ“– Command Examples

1. Basic Greeting

ctx.reply('Hello πŸ‘‹, welcome to BotAlto!');

2. User Info

ctx.replyWithMarkdown(
  `*User Info*:\n- ID: ${ctx.from.id}\n- Name: ${ctx.from.first_name}\n- Username: @${ctx.from.username || 'none'}`
);

3. Send Image

ctx.replyWithPhoto(
  { url: 'https://picsum.photos/600/400' },
  { caption: 'πŸ–ΌοΈ Random image via BotAlto' }
);

4. Inline Keyboard Menu

ctx.reply('Choose an option:', {
  reply_markup: {
    inline_keyboard: [
      [{ text: 'πŸ”” Notify me', callback_data: 'notify' }],
      [{ text: '❓ Help', callback_data: 'help' }]
    ]
  }
});

5. Dice Roll

ctx.replyWithDice();

6. Weather (mock)

const city = ctx.message.text.split(' ')[1] || 'Gujarat';
ctx.reply(`🌀️ ${city}: Sunny, 28°C`);

7. URL Shortener

const url = ctx.message.text.split(' ')[1];
if (!url) return ctx.reply('Usage: /shorten <url>');
ctx.reply(`Short link: https://tinyurl.com/xyz`);

8. CRON reminder (in-chat)

setTimeout(() => ctx.reply('⏰ Reminder fired!'), 5000);

9. Random Joke

const jokes = [
  'Why don’t scientists trust atoms? Because they make up everything!',
  'I would tell you a UDP joke, but you might not get it.'
];
ctx.reply(jokes[Math.floor(Math.random() * jokes.length)]);

10. Markdown / HTML Mix

ctx.replyWithHTML(
  '<b>Bold</b> & <i>Italic</i>\n<a href="https://bot.alto">Visit BotAlto</a>'
);

11. Download & Forward File

ctx.replyWithDocument({ source: 'https://example.com/report.pdf' });

12. Emoji Keyboard

ctx.reply('Pick an emoji:', {
  reply_markup: {
    keyboard: [['πŸ˜€', 'πŸ˜‚', '😍'], ['❀️', 'πŸ‘', 'πŸŽ‰']],
    resize_keyboard: true
  }
});

13. Poll

ctx.poll(
  'Pick your favorite language',
  ['JavaScript', 'Python', 'Go'],
  { is_anonymous: false }
);

14. Sticker Pack

ctx.replyWithSticker('CAACAgIAAxkBAAE...');

15. Send Audio

ctx.replyWithAudio(
  { url: 'https://www.soundjay.com/misc/sounds/bell-ringing-05.mp3' },
  { title: 'Bell Ring' }
);

Screenshots

[Placeholder for dashboard screenshot]

Dashboard

[Placeholder for commands screenshot]

Commands

Technical Details

Backend Architecture

  • Node.js with Express.js server
  • Telegraf.js for Telegram bot integration
  • In-memory storage for bots and commands (persistence coming soon)
  • REST API for frontend communication

Frontend Technology

  • Bootstrap 5 for responsive design
  • Lucide icons for clean UI
  • Vanilla JavaScript for interactivity
  • Modern, clean interface

Future Roadmap

Phase Status Highlights
βœ… v1.0.0 LIVE Core bot creator, hot-reload commands, start/stop per bot, zero-config
βœ… v1.1.0 Next SQLite / MongoDB persistence β†’ bots & commands survive restarts
πŸ”œ v1.2.0 Next JWT or OAuth2 login β†’ manage only your bots
πŸ”œ v1.3.0 Next Real-time usage stats, command heat-map, webhook health
πŸ”œ v2.0.0 Future Plugin marketplace (AI image gen, payments, CRON, etc.)
πŸ”œ v2.1.0 Future Multi-language UI (React-i18n)
πŸ”œ v2.2.0 Future Docker & Kubernetes auto-scaling for 24/7 fleets
πŸ”œ v2.3.0 Future Built-in CI/CD β†’ push code via GitHub Actions
πŸ”œ v3.0.0 Vision AI Copilot β†’ natural-language command generator

Version History

Version Date Changes
1.0.0 2025-08-02 Initial release

Contributing

We welcome contributions! Please fork the repository and submit pull requests. For major changes, please open an issue first to discuss what you'd like to change.

License

MIT


ChildBotHost - Open Source Telegram Bot Platform Server
Developed with ❀️ by Kaiiddo Modified By πŸ–€ Child-Coder

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published