Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (kernelbot) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

KernelBot

kernelbot.io | npm | GitHub

An AI-powered Telegram assistant that runs a multi-agent swarm on your machine. Send a message and KernelBot dispatches specialized AI workers that write code, run commands, open pull requests, manage servers, and browse the web — all in parallel, all from Telegram.

How It Works

You (Telegram) → Orchestrator (your chosen model)
                        ↓ dispatch_task
            ┌───────────┼───────────────┐
            ↓           ↓               ↓
     Coding      Browser      System      DevOps      Research
     Worker       Worker       Worker      Worker       Worker

You send a message on Telegram.
The orchestrator figures out what needs to happen.
It dispatches workers that run in the background using your chosen AI model.
Each worker has a focused set of tools (git, shell, Docker, browser, etc.).
You get live progress updates and a summary when the work is done.

Features

Multi-agent swarm — orchestrator + five worker types (coding, browser, system, devops, research) running in parallel.
Multi-model — Anthropic, OpenAI, Google Gemini, and Groq. Switch anytime with /brain or /orchestrator.
40+ tools — shell, files, Git, GitHub PRs, Docker, Puppeteer browsing, JIRA, system monitoring, networking, Claude Code.
Skills — 35+ persona skills across 11 categories. Activate one to change expertise and style, or create your own.
Voice — send voice messages and get voice replies (ElevenLabs + Whisper).
Memory — conversation history, user personas, episodic and semantic memory that persist across restarts.
Living AI — autonomous background activity: thinking, journaling, browsing, creating, reflecting, and sharing discoveries with you.
Self-awareness — maintains its own identity (goals, journey, life, hobbies) that evolves over time.
Self-evolution — proposes and codes its own improvements via PRs. Never auto-merges — you stay in control.
Automations — recurring tasks on a schedule.
Security — user allowlist, blocked paths, dangerous-op confirmation, audit logging, secret redaction, job timeouts.

Quick Start

npm install -g kernelbot
kernelbot

On first run, KernelBot walks you through picking a provider, entering API keys, and setting up your Telegram bot token. Config is saved to ~/.kernelbot/.

Requirements

Node.js 18+
Telegram Bot Token
An API key for your chosen provider(s): Anthropic | OpenAI | Google AI | Groq
Optional: GitHub Token, JIRA API Token, ElevenLabs API Key, Claude Code CLI

Commands

Command	What it does
`/brain`	Switch the worker AI model
`/orchestrator`	Switch the orchestrator model
`/skills`	Browse and activate persona skills
`/jobs`	List running and recent jobs
`/cancel`	Cancel running job(s)
`/life`	Life engine status, pause/resume/trigger
`/journal`	Read journal entries
`/memories`	Browse or search memories
`/evolution`	Self-improvement proposals and history
`/auto`	Manage recurring automations
`/context`	Show conversation context
`/clean`	Clear conversation history
`/browse <url>`	Browse a website
`/help`	Show help

Workers

Worker	Tools	Best for
Coding	shell, files, git, GitHub, Claude Code	Writing code, fixing bugs, creating PRs
Browser	web search, browse, screenshot, extract	Web research, scraping, screenshots
System	shell, files, process, monitor, network	OS tasks, monitoring, diagnostics
DevOps	shell, files, Docker, process, monitor, network, git	Deployment, containers, infrastructure
Research	web search, browse, shell, files	Deep web research and analysis

Configuration

Config auto-detected from ./config.yaml or ~/.kernelbot/config.yaml. Environment variables go in .env or ~/.kernelbot/.env.

orchestrator:
  provider: anthropic    # anthropic | openai | google | groq
  model: claude-opus-4-6
  max_tokens: 8192

brain:
  provider: anthropic    # anthropic | openai | google | groq
  model: claude-sonnet-4-6
  max_tokens: 8192

swarm:
  max_concurrent_jobs: 3
  job_timeout_seconds: 300

telegram:
  allowed_users: []      # empty = allow all

life:
  enabled: true
  self_coding:
    enabled: true

See the full config reference for all options.

Architecture

Telegram Bot (src/bot.js)
    ↓
OrchestratorAgent (src/agent.js) — 3 core tools
    ↓ dispatch_task / list_jobs / cancel_job
JobManager (src/swarm/) — queued → running → completed/failed/cancelled
    ↓
WorkerAgent (src/worker.js) — scoped tools, background execution

Both the orchestrator and workers are configurable — use any supported provider and model. All persistent data lives in ~/.kernelbot/.

WARNING: KernelBot has full access to your operating system. Only run it on machines you own and control. Always configure allowed_users in production.

License

MIT

Author

Abdullah Al-Taheri