kernelbot 1.0.24 → 1.0.26

package/.env.example

@@ -1,5 +1,13 @@
+# AI provider API keys (only the one matching your brain.provider is required)
 ANTHROPIC_API_KEY=sk-ant-...
+OPENAI_API_KEY=sk-...
+GOOGLE_API_KEY=AIza...
+GROQ_API_KEY=gsk_...
+
+# Required
 TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
+
+# Optional
 GITHUB_TOKEN=ghp_...
 JIRA_BASE_URL=https://yourcompany.atlassian.net
 JIRA_EMAIL=you@company.com

package/README.md

@@ -1,13 +1,14 @@
 # KernelBot
 
-[kernelbot.io](https://kernelbot.io) | [npm](https://www.npmjs.com/package/kernelbot) | [GitHub](https://github.com/KernelCode/KERNEL)
+[kernelbot.io](https://kernelbot.io) | [npm](https://www.npmjs.com/package/kernelbot) | [GitHub](https://github.com/KernelCode/kernelbot)
 
-AI engineering agent — a Telegram bot backed by Claude with full OS control via tool use.
+AI engineering agent — a Telegram bot backed by Claude, GPT, Gemini, or Groq with full OS control via tool use.
 
 Send a message in Telegram, and KernelBot will read files, write code, run commands, browse the web, manage infrastructure, and respond with the results. It's your personal engineering assistant with direct access to your machine.
 
 ## Features
 
+- **Multi-model support** — choose your AI brain: Anthropic (Claude), OpenAI (GPT), Google (Gemini), or Groq (Llama/Mixtral). Switch models anytime from the CLI menu
 - **Autonomous agent loop** — send one message and KernelBot chains tool calls until the task is done, no hand-holding needed
 - **Full shell access** — run any command, install packages, build projects, run tests
 - **File management** — read, write, and create files with automatic directory creation
@@ -30,14 +31,14 @@ Send a message in Telegram, and KernelBot will read files, write code, run comma
 ## How It Works
 
 ```text
-You (Telegram) → KernelBot → Claude (Anthropic API)
+You (Telegram) → KernelBot → AI Brain (Claude / GPT / Gemini / Groq)
                                    ↕
                       Tools (shell, files, git, docker, browser, etc.)
                                    ↕
                       Claude Code CLI (coding tasks)
 ```
 
-KernelBot runs a **tool-use loop**: Claude decides which tools to call, KernelBot executes them on your OS, feeds results back, and Claude continues until the task is done. One message can trigger dozens of tool calls autonomously.
+KernelBot runs a **tool-use loop**: the AI decides which tools to call, KernelBot executes them on your OS, feeds results back, and the AI continues until the task is done. One message can trigger dozens of tool calls autonomously.
 
 For complex coding tasks, KernelBot can spawn **Claude Code CLI** as a sub-agent — giving it a dedicated coding environment with its own tool loop for writing, editing, and debugging code.
 
@@ -45,85 +46,85 @@ For complex coding tasks, KernelBot can spawn **Claude Code CLI** as a sub-agent
 
 ### File System & Shell
 
-| Tool | Description |
-| --- | --- |
-| `execute_command` | Run any shell command (git, npm, python, etc.) |
-| `read_file` | Read file contents with optional line limits |
-| `write_file` | Write/create files, auto-creates parent directories |
-| `list_directory` | List directory contents, optionally recursive |
+| Tool              | Description                                         |
+| ----------------- | --------------------------------------------------- |
+| `execute_command` | Run any shell command (git, npm, python, etc.)      |
+| `read_file`       | Read file contents with optional line limits        |
+| `write_file`      | Write/create files, auto-creates parent directories |
+| `list_directory`  | List directory contents, optionally recursive       |
 
 ### Git & GitHub
 
-| Tool | Description |
-| --- | --- |
-| `git_clone` | Clone a repo (`org/repo` shorthand or full URL) |
-| `git_checkout` | Checkout or create branches |
-| `git_commit` | Stage all changes and commit |
-| `git_push` | Push current branch to remote |
-| `git_diff` | Show uncommitted changes |
-| `github_create_pr` | Create a pull request |
-| `github_get_pr_diff` | Get the diff of a PR |
-| `github_post_review` | Post a review on a PR |
-| `github_create_repo` | Create a new GitHub repository |
-| `github_list_prs` | List pull requests for a repo |
+| Tool                 | Description                                     |
+| -------------------- | ----------------------------------------------- |
+| `git_clone`          | Clone a repo (`org/repo` shorthand or full URL) |
+| `git_checkout`       | Checkout or create branches                     |
+| `git_commit`         | Stage all changes and commit                    |
+| `git_push`           | Push current branch to remote                   |
+| `git_diff`           | Show uncommitted changes                        |
+| `github_create_pr`   | Create a pull request                           |
+| `github_get_pr_diff` | Get the diff of a PR                            |
+| `github_post_review` | Post a review on a PR                           |
+| `github_create_repo` | Create a new GitHub repository                  |
+| `github_list_prs`    | List pull requests for a repo                   |
 
 ### Web Browsing
 
-| Tool | Description |
-| --- | --- |
-| `browse_website` | Navigate to a URL and extract page content (title, headings, text, links) |
-| `screenshot_website` | Take a screenshot of a website, supports full-page and element capture |
-| `extract_content` | Extract specific content using CSS selectors |
-| `interact_with_page` | Click, type, scroll, and run JS on a webpage |
-| `send_image` | Send an image/screenshot directly to the Telegram chat |
+| Tool                 | Description                                                               |
+| -------------------- | ------------------------------------------------------------------------- |
+| `browse_website`     | Navigate to a URL and extract page content (title, headings, text, links) |
+| `screenshot_website` | Take a screenshot of a website, supports full-page and element capture    |
+| `extract_content`    | Extract specific content using CSS selectors                              |
+| `interact_with_page` | Click, type, scroll, and run JS on a webpage                              |
+| `send_image`         | Send an image/screenshot directly to the Telegram chat                    |
 
 ### JIRA
 
-| Tool | Description |
-| --- | --- |
-| `jira_get_ticket` | Get details of a specific JIRA ticket |
-| `jira_search_tickets` | Search tickets using JQL queries |
-| `jira_list_my_tickets` | List tickets assigned to the current user |
-| `jira_get_project_tickets` | Get tickets from a specific JIRA project |
+| Tool                       | Description                               |
+| -------------------------- | ----------------------------------------- |
+| `jira_get_ticket`          | Get details of a specific JIRA ticket     |
+| `jira_search_tickets`      | Search tickets using JQL queries          |
+| `jira_list_my_tickets`     | List tickets assigned to the current user |
+| `jira_get_project_tickets` | Get tickets from a specific JIRA project  |
 
 ### Docker
 
-| Tool | Description |
-| --- | --- |
-| `docker_ps` | List containers |
-| `docker_logs` | Get container logs |
-| `docker_exec` | Execute a command inside a running container |
-| `docker_compose` | Run docker compose commands |
+| Tool             | Description                                  |
+| ---------------- | -------------------------------------------- |
+| `docker_ps`      | List containers                              |
+| `docker_logs`    | Get container logs                           |
+| `docker_exec`    | Execute a command inside a running container |
+| `docker_compose` | Run docker compose commands                  |
 
 ### Process & System
 
-| Tool | Description |
-| --- | --- |
-| `process_list` | List running processes, optionally filter by name |
-| `kill_process` | Kill a process by PID or name |
+| Tool              | Description                                            |
+| ----------------- | ------------------------------------------------------ |
+| `process_list`    | List running processes, optionally filter by name      |
+| `kill_process`    | Kill a process by PID or name                          |
 | `service_control` | Manage systemd services (start, stop, restart, status) |
 
 ### Monitoring
 
-| Tool | Description |
-| --- | --- |
-| `disk_usage` | Show disk space usage |
-| `memory_usage` | Show RAM usage |
-| `cpu_usage` | Show CPU load |
-| `system_logs` | Read system or application logs |
+| Tool           | Description                     |
+| -------------- | ------------------------------- |
+| `disk_usage`   | Show disk space usage           |
+| `memory_usage` | Show RAM usage                  |
+| `cpu_usage`    | Show CPU load                   |
+| `system_logs`  | Read system or application logs |
 
 ### Networking
 
-| Tool | Description |
-| --- | --- |
-| `check_port` | Check if a port is open and listening |
-| `curl_url` | Make HTTP requests and return the response |
-| `nginx_reload` | Test nginx config and reload if valid |
+| Tool           | Description                                |
+| -------------- | ------------------------------------------ |
+| `check_port`   | Check if a port is open and listening      |
+| `curl_url`     | Make HTTP requests and return the response |
+| `nginx_reload` | Test nginx config and reload if valid      |
 
 ### Coding
 
-| Tool | Description |
-| --- | --- |
+| Tool                | Description                                                                               |
+| ------------------- | ----------------------------------------------------------------------------------------- |
 | `spawn_claude_code` | Spawn Claude Code CLI for coding tasks — writing, fixing, reviewing, and scaffolding code |
 
 ## Disclaimer
@@ -144,10 +145,13 @@ kernelbot
 
 That's it. On first run, KernelBot will:
 
-1. Detect missing credentials and prompt for them
-2. Save them to `~/.kernelbot/.env`
-3. Verify API connections
-4. Launch the Telegram bot
+1. Prompt you to select an AI provider and model
+2. Ask for your API key and Telegram bot token
+3. Save credentials to `~/.kernelbot/.env`
+4. Verify API connections
+5. Launch the Telegram bot
+
+You can change your AI provider/model anytime from the CLI menu (option 5).
 
 ## Configuration
 
@@ -158,7 +162,12 @@ KernelBot auto-detects config from the current directory or `~/.kernelbot/`. Eve
 Set these in `.env` or as system environment variables:
 
 ```text
-ANTHROPIC_API_KEY=sk-ant-...
+# AI provider key (only the one matching your provider is required)
+ANTHROPIC_API_KEY=sk-ant-...     # for Anthropic (Claude)
+OPENAI_API_KEY=sk-...            # for OpenAI (GPT)
+GOOGLE_API_KEY=AIza...           # for Google (Gemini)
+GROQ_API_KEY=gsk_...             # for Groq (Llama/Mixtral)
+
 TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
 GITHUB_TOKEN=ghp_...                           # optional, for GitHub tools
 JIRA_BASE_URL=https://yourcompany.atlassian.net # optional, for JIRA tools
@@ -174,7 +183,8 @@ Drop a `config.yaml` in your working directory or `~/.kernelbot/` to customize b
 bot:
   name: KernelBot
 
-anthropic:
+brain:
+  provider: anthropic    # anthropic | openai | google | groq
   model: claude-sonnet-4-20250514
   max_tokens: 8192
   temperature: 0.3
@@ -209,11 +219,12 @@ conversation:
 
 ## Telegram Commands
 
-| Command | Description |
-| --- | --- |
-| `/clean` | Clear conversation and start fresh |
-| `/history` | Show message count in memory |
-| `/help` | Show help message |
+| Command    | Description                                    |
+| ---------- | ---------------------------------------------- |
+| `/brain`   | Show current AI model and switch provider/model |
+| `/clean`   | Clear conversation and start fresh             |
+| `/history` | Show message count in memory                   |
+| `/help`    | Show help message                              |
 
 ## Security
 
@@ -256,12 +267,18 @@ KernelBot/
 ├── bin/
 │   └── kernel.js              # Entry point + CLI menu
 ├── src/
-│   ├── agent.js               # Claude tool-use loop
+│   ├── agent.js               # AI tool-use loop (provider-agnostic)
 │   ├── bot.js                 # Telegram bot (polling, auth, message handling)
 │   ├── coder.js               # Claude Code CLI spawner + smart output
 │   ├── conversation.js        # Per-chat conversation history
 │   ├── prompts/
 │   │   └── system.js          # System prompt
+│   ├── providers/
+│   │   ├── models.js          # Provider & model catalog
+│   │   ├── base.js            # Abstract provider interface
+│   │   ├── anthropic.js       # Anthropic (Claude) provider
+│   │   ├── openai-compat.js   # OpenAI / Gemini / Groq provider
+│   │   └── index.js           # Provider factory
 │   ├── security/
 │   │   ├── auth.js            # User allowlist
 │   │   ├── audit.js           # Tool call audit logging
@@ -290,7 +307,11 @@ KernelBot/
 ## Requirements
 
 - Node.js 18+
-- [Anthropic API key](https://console.anthropic.com/)
+- AI provider API key (one of):
+  - [Anthropic API key](https://console.anthropic.com/) (Claude)
+  - [OpenAI API key](https://platform.openai.com/api-keys) (GPT)
+  - [Google AI API key](https://aistudio.google.com/apikey) (Gemini)
+  - [Groq API key](https://console.groq.com/keys) (Llama/Mixtral)
 - [Telegram Bot Token](https://t.me/BotFather)
 - Chromium/Chrome (for browser tools — installed automatically by Puppeteer)
 - [GitHub Token](https://github.com/settings/tokens) (optional, for GitHub tools)

package/bin/kernel.js

@@ -9,7 +9,7 @@ import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
 import chalk from 'chalk';
-import { loadConfig, loadConfigInteractive } from '../src/utils/config.js';
+import { loadConfig, loadConfigInteractive, changeBrainModel } from '../src/utils/config.js';
 import { createLogger, getLogger } from '../src/utils/logger.js';
 import {
   showLogo,
@@ -21,16 +21,23 @@ import { createAuditLogger } from '../src/security/audit.js';
 import { ConversationManager } from '../src/conversation.js';
 import { Agent } from '../src/agent.js';
 import { startBot } from '../src/bot.js';
-import Anthropic from '@anthropic-ai/sdk';
+import { createProvider, PROVIDERS } from '../src/providers/index.js';
 
-function showMenu() {
+function showMenu(config) {
+  const providerDef = PROVIDERS[config.brain.provider];
+  const providerName = providerDef ? providerDef.name : config.brain.provider;
+  const modelId = config.brain.model;
+
+  console.log('');
+  console.log(chalk.dim(`  Current brain: ${providerName} / ${modelId}`));
   console.log('');
   console.log(chalk.bold('  What would you like to do?\n'));
   console.log(`  ${chalk.cyan('1.')} Start bot`);
   console.log(`  ${chalk.cyan('2.')} Check connections`);
   console.log(`  ${chalk.cyan('3.')} View logs`);
   console.log(`  ${chalk.cyan('4.')} View audit logs`);
-  console.log(`  ${chalk.cyan('5.')} Exit`);
+  console.log(`  ${chalk.cyan('5.')} Change brain model`);
+  console.log(`  ${chalk.cyan('6.')} Exit`);
   console.log('');
 }
 
@@ -70,21 +77,21 @@ function viewLog(filename) {
 }
 
 async function runCheck(config) {
-  await showStartupCheck('ANTHROPIC_API_KEY', async () => {
-    if (!config.anthropic.api_key) throw new Error('Not set');
+  const providerDef = PROVIDERS[config.brain.provider];
+  const providerLabel = providerDef ? providerDef.name : config.brain.provider;
+  const envKeyLabel = providerDef ? providerDef.envKey : 'API_KEY';
+
+  await showStartupCheck(envKeyLabel, async () => {
+    if (!config.brain.api_key) throw new Error('Not set');
   });
 
   await showStartupCheck('TELEGRAM_BOT_TOKEN', async () => {
     if (!config.telegram.bot_token) throw new Error('Not set');
   });
 
-  await showStartupCheck('Anthropic API connection', async () => {
-    const client = new Anthropic({ apiKey: config.anthropic.api_key });
-    await client.messages.create({
-      model: config.anthropic.model,
-      max_tokens: 16,
-      messages: [{ role: 'user', content: 'ping' }],
-    });
+  await showStartupCheck(`${providerLabel} API connection`, async () => {
+    const provider = createProvider(config);
+    await provider.ping();
   });
 
   await showStartupCheck('Telegram Bot API', async () => {
@@ -102,16 +109,15 @@ async function startBotFlow(config) {
   createAuditLogger();
   const logger = getLogger();
 
+  const providerDef = PROVIDERS[config.brain.provider];
+  const providerLabel = providerDef ? providerDef.name : config.brain.provider;
+
   const checks = [];
 
   checks.push(
-    await showStartupCheck('Anthropic API', async () => {
-      const client = new Anthropic({ apiKey: config.anthropic.api_key });
-      await client.messages.create({
-        model: config.anthropic.model,
-        max_tokens: 16,
-        messages: [{ role: 'user', content: 'ping' }],
-      });
+    await showStartupCheck(`${providerLabel} API`, async () => {
+      const provider = createProvider(config);
+      await provider.ping();
     }),
   );
 
@@ -148,7 +154,7 @@ async function main() {
 
   let running = true;
   while (running) {
-    showMenu();
+    showMenu(config);
     const choice = await ask(rl, chalk.cyan('  > '));
 
     switch (choice.trim()) {
@@ -168,6 +174,9 @@ async function main() {
         viewLog('kernel-audit.log');
         break;
       case '5':
+        await changeBrainModel(config, rl);
+        break;
+      case '6':
         running = false;
         break;
       default:

package/config.example.yaml

@@ -5,7 +5,8 @@ bot:
   name: KernelBot
   description: AI engineering agent with full OS control
 
-anthropic:
+brain:
+  provider: anthropic    # anthropic | openai | google | groq
   model: claude-sonnet-4-20250514
   max_tokens: 8192
   temperature: 0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kernelbot",
-  "version": "1.0.24",
+  "version": "1.0.26",
   "description": "KernelBot — AI engineering agent with full OS control",
   "type": "module",
   "author": "Abdullah Al-Taheri <abdullah@altaheri.me>",
@@ -15,6 +15,9 @@
     "agent",
     "telegram",
     "anthropic",
+    "openai",
+    "gemini",
+    "groq",
     "tools"
   ],
   "repository": {
@@ -37,6 +40,7 @@
     "gradient-string": "^3.0.0",
     "js-yaml": "^4.1.0",
     "node-telegram-bot-api": "^0.66.0",
+    "openai": "^4.82.0",
     "ora": "^8.1.1",
     "puppeteer": "^24.37.3",
     "simple-git": "^3.31.1",