{"id":47597583,"url":"https://github.com/isaacsight/kernel","last_synced_at":"2026-04-01T18:26:55.330Z","repository":{"id":326308013,"uuid":"1101710279","full_name":"isaacsight/kernel","owner":"isaacsight","description":"kbot — the AI agent that builds its own tools and defends itself. 384+ tools, 41 agents, 19 local models, 20 providers. Finance stack, cybersecurity suite, self-defense system. Always-on daemon. Runs offline. npm i -g @kernel.chat/kbot","archived":false,"fork":false,"pushed_at":"2026-03-27T17:15:28.000Z","size":393969,"stargazers_count":5,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-27T22:39:40.215Z","etag":null,"topics":["ai-agent","anthropic","cli","coding-agent","cybersecurity","defi","kbot","llm","local-ai","mcp","nvidia","ollama","open-source","openai","self-improving","solana","terminal","tool-creation","trading-bot","typescript"],"latest_commit_sha":null,"homepage":"https://kernel.chat","language":"TypeScript","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/isaacsight.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":"SECURITY.md","support":null,"governance":"GOVERNANCE.md","roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-22T05:04:34.000Z","updated_at":"2026-03-27T18:20:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/isaacsight/kernel","commit_stats":null,"previous_names":["isaacsight/does-this-feel-right-","isaacsight/kernel"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/isaacsight/kernel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isaacsight%2Fkernel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isaacsight%2Fkernel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isaacsight%2Fkernel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isaacsight%2Fkernel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/isaacsight","download_url":"https://codeload.github.com/isaacsight/kernel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isaacsight%2Fkernel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31172543,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-29T21:28:10.185Z","status":"online","status_checked_at":"2026-03-30T02:00:06.831Z","response_time":138,"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-agent","anthropic","cli","coding-agent","cybersecurity","defi","kbot","llm","local-ai","mcp","nvidia","ollama","open-source","openai","self-improving","solana","terminal","tool-creation","trading-bot","typescript"],"created_at":"2026-04-01T18:26:54.463Z","updated_at":"2026-04-01T18:26:55.321Z","avatar_url":"https://github.com/isaacsight.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cstrong\u003ekbot\u003c/strong\u003e\u003cbr\u003e\n  Open-source terminal AI agent. 35 agents. 600+ tools. 20 providers. Science, finance, security, and more.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"tools/video-assets/demo.gif\" alt=\"kbot demo\" width=\"700\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/isaacsight/kernel/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/isaacsight/kernel/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@kernel.chat/kbot\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@kernel.chat/kbot?color=6B5B95\u0026label=npm\" alt=\"npm version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@kernel.chat/kbot\"\u003e\u003cimg src=\"https://img.shields.io/npm/dw/@kernel.chat/kbot?color=6B5B95\" alt=\"npm downloads\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/isaacsight/kernel/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/isaacsight/kernel?color=6B5B95\" alt=\"MIT License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://kernel.chat\"\u003e\u003cimg src=\"https://img.shields.io/badge/web-kernel.chat-6B5B95\" alt=\"kernel.chat\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://discord.gg/kdMauM9abG\"\u003e\u003cimg src=\"https://img.shields.io/badge/discord-join-6B5B95?logo=discord\u0026logoColor=white\" alt=\"Discord\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n```bash\nnpm install -g @kernel.chat/kbot\n```\n\n## Why kbot?\n\nMost terminal AI agents lock you into one provider, one model, one way of working. kbot doesn't.\n\n- **20 providers, zero lock-in** — Claude, GPT, Gemini, Grok, DeepSeek, Groq, Mistral, SambaNova, Cerebras, OpenRouter, and more. Switch with one command.\n- **Runs fully offline** — Embedded llama.cpp, Ollama, LM Studio, or Jan. $0, fully private.\n- **Learns your patterns** — Bayesian skill ratings + pattern extraction. Gets faster over time.\n- **35 specialist agents** — auto-routes your request to the right expert (coder, researcher, writer, guardian, quant, and 30 more).\n- **600+ tools** — files, bash, git, GitHub, web search, deploy, database, game dev, VFX, research, science, finance, security, and more.\n- **Programmatic SDK** — use kbot as a library in your own apps.\n- **MCP server built in** — plug kbot into Claude Code, Cursor, VS Code, Zed, or Neovim as a tool provider.\n\n### How it compares\n\n| | kbot | Claude Code | Codex CLI | Aider | OpenCode |\n|---|---|---|---|---|---|\n| AI providers | 20 | 1 | 1 | 6 | 75+ |\n| Specialist agents | 35 | 0 | 0 | 0 | 0 |\n| Built-in tools | 600+ | ~20 | ~15 | ~10 | ~15 |\n| Science tools | 114 | 0 | 0 | 0 | 0 |\n| Learning engine | Yes | No | No | No | No |\n| Offline mode | Embedded + Ollama | No | No | Ollama | Ollama |\n| SDK | Yes | No | Yes | No | No |\n| MCP server | Yes | N/A | No | No | No |\n| Web companion | kernel.chat | No | No | No | No |\n| Open source | MIT | Source available | Apache 2.0 | Apache 2.0 | MIT |\n| Cost | BYOK / $0 local | $20+/mo | BYOK | BYOK | BYOK |\n\n## Quick Start\n\n```bash\n# Install globally\nnpm install -g @kernel.chat/kbot\n\n# Or run directly (no install)\nnpx @kernel.chat/kbot\n\n# Or use the install script (auto-installs Node.js if needed)\ncurl -fsSL https://kernel.chat/install.sh | bash\n```\n\n```bash\n# Interactive mode\nkbot\n\n# One-shot\nkbot \"explain this codebase\"\nkbot \"fix the auth bug in src/auth.ts\"\nkbot \"create a Dockerfile for this project\"\n\n# Pipe mode (for scripting)\nkbot -p \"generate a migration for user roles\" \u003e migration.sql\n\n# Use local models (free, no API key)\nkbot local\n\n# Set up your API key\nkbot auth\n```\n\n## Specialists\n\nkbot auto-routes to the right agent for each task. Or pick one with `--agent \u003cname\u003e`.\n\n| | Agents |\n|---|---|\n| **Core** | kernel, researcher, coder, writer, analyst |\n| **Extended** | aesthete, guardian, curator, strategist |\n| **Domain** | infrastructure, quant, investigator, oracle, chronist, sage, communicator, adapter |\n| **Presets** | claude-code, cursor, copilot, creative, developer |\n\n## 600+ Tools\n\n| Category | Examples |\n|----------|---------|\n| **Files \u0026 Code** | read, write, glob, grep, lint, format, type-check |\n| **Shell** | bash, parallel execute, background tasks |\n| **Git \u0026 GitHub** | commit, diff, PR, issues, code search |\n| **Web** | search, fetch, browser automation, browser agent |\n| **Research** | arXiv, Semantic Scholar, HuggingFace, NASA, DOI |\n| **Data** | CSV read/query/write, transforms, reports, invoices |\n| **Quality** | lint (ESLint/Biome/Clippy), test (Vitest/Jest/pytest), deps audit, formatting |\n| **Deploy** | Vercel, Netlify, Cloudflare Workers/Pages, Fly.io, Railway |\n| **Database** | Postgres, MySQL, SQLite queries, Prisma, ER diagrams, seed data |\n| **Containers** | Docker build/run/compose, Terraform |\n| **Creative** | p5.js generative art, GLSL shaders, SVG patterns, design variants |\n| **VFX** | GLSL shaders, FFmpeg, ImageMagick, Blender, procedural textures |\n| **Game Dev** | 16 tools for Godot, Unity, Unreal, Bevy, Phaser, Three.js, PlayCanvas, Defold |\n| **Training** | dataset prep, fine-tuning, evaluation, model export |\n| **Social** | post to X, LinkedIn, Bluesky, Mastodon — single posts and threads |\n| **Sandbox** | Docker sandboxes, E2B cloud sandboxes, isolated code execution |\n| **Notebooks** | Jupyter read/edit/insert/delete cells |\n| **Build Matrix** | cross-platform builds — mobile, desktop, WASM, embedded, server |\n| **LSP** | goto definition, find references, hover, rename, diagnostics |\n| **Memory** | persistent memory save/search/update across sessions |\n| **MCP** | marketplace search/install, 20 bundled servers |\n| **IDE** | MCP server, ACP server, LSP bridge |\n| **Forge** | create tools at runtime, publish to registry, install from registry |\n| **Meta** | subagents, worktrees, planner, sessions, checkpoints, self-eval |\n| **Science \u0026 Math** | symbolic compute, matrix ops, FFT, ODEs, probability, optimization, graph theory, OEIS |\n| **Physics** | orbital mechanics, circuits, signal processing, particles (PDG), relativity, quantum simulator, beam analysis, fluid dynamics |\n| **Chemistry** | PubChem compounds, reactions, periodic table (118 elements), spectroscopy, stoichiometry, thermodynamics |\n| **Biology** | PubMed, gene lookup, protein/PDB, BLAST, drug/ChEMBL, pathways, taxonomy, clinical trials |\n| **Earth \u0026 Climate** | earthquakes/USGS, climate/NOAA, satellite imagery, geology, ocean, air quality, volcanoes, water resources |\n| **Neuroscience** | brain atlas, EEG analysis, cognitive models, neural simulation, connectome, psychophysics |\n| **Social Science** | psychometrics, game theory, econometrics, social network analysis, survey design, voting systems |\n| **Humanities** | corpus analysis, formal logic, argument mapping, ethics frameworks, historical timelines, stylometry |\n| **Health \u0026 Epidemiology** | SIR/SEIR models, epidemiology calculations, disease surveillance, nutrition, vaccination modeling |\n| **Finance** | market data, technical analysis, paper trading, DeFi yields, wallet \u0026 swaps, stock screener, sentiment |\n| **Cybersecurity** | dep_audit, secret_scan, ssl_check, headers_check, cve_lookup, port_scan, owasp_check |\n| **Self-Defense** | memory HMAC, prompt injection detection, knowledge sanitization, forge verification, anomaly detection |\n\n## 20 Providers\n\n| Provider | Cost | Local? |\n|----------|------|--------|\n| **Embedded (llama.cpp)** | **Free** | Yes |\n| **Ollama** | **Free** | Yes |\n| **LM Studio** | **Free** | Yes |\n| **Jan** | **Free** | Yes |\n| DeepSeek | $0.27/M in | Cloud |\n| SambaNova | $0.50/M in | Cloud |\n| Cerebras | $0.60/M in | Cloud |\n| Groq | $0.59/M in | Cloud |\n| NVIDIA NIM | $0.80/M in | Cloud |\n| Together AI | $0.88/M in | Cloud |\n| Fireworks AI | $0.90/M in | Cloud |\n| Google (Gemini) | $1.25/M in | Cloud |\n| Mistral | $2.00/M in | Cloud |\n| OpenAI (GPT) | $2.00/M in | Cloud |\n| Cohere | $2.50/M in | Cloud |\n| Anthropic (Claude) | $3.00/M in | Cloud |\n| xAI (Grok) | $3.00/M in | Cloud |\n| Perplexity | $3.00/M in | Cloud |\n| OpenRouter | varies | Cloud |\n| kbot local | **Free** | Yes |\n\nSet any provider's env var and kbot auto-detects it. Or run `kbot auth` for interactive setup.\n\n## SDK\n\n```typescript\nimport { agent, tools, providers } from '@kernel.chat/kbot'\n\nconst result = await agent.run(\"fix the auth bug\", { agent: 'coder' })\nconsole.log(result.content)\n\nfor await (const event of agent.stream(\"explain this code\")) {\n  if (event.type === 'content_delta') process.stdout.write(event.text)\n}\n```\n\n## Architecture\n\n```mermaid\ngraph TD\n    A[User Message] --\u003e B{Local-first check}\n    B --\u003e|file, git, grep| C[Instant response — $0]\n    B --\u003e|Needs AI| D{Complexity detection}\n    D --\u003e|Simple| E[Bayesian Router → Specialist]\n    D --\u003e|Multi-step| F[Autonomous Planner]\n    E --\u003e G[Provider API + Tool Loop]\n    F --\u003e G\n    G --\u003e H{600+ Tools}\n    H --\u003e I[File ops, bash, git, GitHub, search, deploy, DB, game dev...]\n    G --\u003e J[Learning Engine]\n    J --\u003e K[Patterns + Solutions + User Profile]\n    G --\u003e L[Checkpointing]\n    L --\u003e M[Resume from last tool call]\n```\n\n## MCP Server\n\nUse kbot as a tool provider inside any MCP-compatible IDE:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"kbot\": { \"command\": \"kbot\", \"args\": [\"ide\", \"mcp\"] }\n    }\n  }\n}\n```\n\nWorks with Claude Code, Cursor, VS Code, Windsurf, Zed, Neovim.\n\n## Commands\n\n| Command | What it does |\n|---------|-------------|\n| `kbot` | Interactive REPL |\n| `kbot \"prompt\"` | One-shot execution |\n| `kbot auth` | Configure API key |\n| `kbot local` | Use local AI (Ollama, embedded, LM Studio, Jan) |\n| `kbot serve` | Start HTTP REST + SSE streaming server |\n| `kbot audit \u003crepo\u003e` | Security + quality audit of any GitHub repo |\n| `kbot contribute \u003crepo\u003e` | Find good-first-issues and quick wins |\n| `kbot share` | Share conversation as GitHub Gist |\n| `kbot pair` | File watcher with auto-analysis |\n| `kbot team` | Multi-agent TCP collaboration |\n| `kbot record` | Terminal session recording (SVG, GIF, asciicast) |\n| `kbot voice` | Text-to-speech output mode |\n| `kbot watch` | Real-time file analysis on change |\n| `kbot bootstrap` | Outer-loop project optimizer (visibility scoring) |\n| `kbot plugins` | Search, install, update community plugins |\n| `kbot models` | List, pull, remove, catalog local models |\n| `kbot changelog` | Generate changelog from git history |\n| `kbot completions` | Shell completions (bash, zsh, fish) |\n| `kbot cloud` | Sync learning data to kernel.chat |\n| `kbot ide mcp` | Start MCP server for IDEs |\n| `kbot doctor` | 10-point health check |\n\n### Power-User Flags\n\n```bash\nkbot --architect \"design the auth system\"    # Architecture mode — plan before code\nkbot --thinking \"solve this hard problem\"    # Extended reasoning with thinking budget\nkbot --self-eval \"write a parser\"            # Self-evaluation loop — scores and retries\nkbot --computer-use \"fill out this form\"     # Computer use — controls mouse and keyboard\nkbot -p \"query\" \u003e output.txt                 # Pipe mode — clean output for scripting\n```\n\n## Security\n\n- API keys encrypted at rest (AES-256-CBC)\n- Destructive operations require confirmation\n- Shell commands sandboxed with blocklist\n- Tool execution timeout (5 min) with middleware pipeline\n- Config files restricted to owner (chmod 600)\n- 0 P0/P1 security issues (audited March 2026)\n\n## Development\n\n```bash\ncd packages/kbot\nnpm install\nnpm run dev          # Run in dev mode\nnpm run build        # Compile TypeScript\nnpm run test         # Run tests (vitest)\n```\n\n## Web Companion — kernel.chat\n\nkbot has a web companion at [kernel.chat](https://kernel.chat) — same agents, persistent memory, and a visual interface. Free to use (20 messages/day).\n\n## Community\n\n- **Web**: [kernel.chat](https://kernel.chat)\n- **npm**: [@kernel.chat/kbot](https://www.npmjs.com/package/@kernel.chat/kbot)\n- **Discord**: [discord.gg/kdMauM9abG](https://discord.gg/kdMauM9abG)\n- **GitHub**: [isaacsight/kernel](https://github.com/isaacsight/kernel)\n- **Issues**: [Report a bug](https://github.com/isaacsight/kernel/issues)\n\n## License\n\n[MIT](LICENSE) — [kernel.chat group](https://kernel.chat)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisaacsight%2Fkernel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fisaacsight%2Fkernel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisaacsight%2Fkernel/lists"}