KISS Agent Framework - A simple and portable agent framework for building and evolving AI agents
Project description
"Everything should be made as simple as possible, but not simpler." — Albert Einstein
KISS Sorcar
Open-source general-purpose AI agent for long-horizon tasks and AI discovery
KISS Sorcar is a free, simple, local-first, bring-your-own-key AI agent framework. It runs as a VS Code extension, a Claude-Code-style CLI, and a browser/mobile web app. Your prompts and code are sent directly to the model provider or local endpoint you configure — not through our servers. It supports multi-model workflows just via prompts. All agents run as daemons. Complex AI systems/techniques can be replaced with a paragraph of prompt in KISS Sorcar.
curl -fsSL https://raw.githubusercontent.com/ksenxx/kiss_ai/main/scripts/install.sh | bash
Table of Contents
🆚 KISS Sorcar vs Claude Code vs Cursor
| Capability | KISS Sorcar | Claude Code | Cursor |
|---|---|---|---|
| Interfaces | CLI + VS Code extension + web/mobile app | CLI + mobile app | Custom VS Code |
| AI Discovery | ✅ simply via prompt | ❌ | ❌ |
| GEPA Prompt Optimization | ✅ simply via prompt | ❌ | ❌ |
| Multiple models from multiple vendors in the same task | ✅ Mix OpenAI, Anthropic, Gemini, Together, Z.AI, Moonshot AI, OpenRouter, Claude Code CLI, and Codex CLI | ❌ Anthropic Claude models only | ❌ One model per task |
| Primary focus | ✅ Quality — rigorous review, end-to-end tests | Speed and developer ergonomics | Speed |
| Core Agents # LoC | ~2850 | Unknown | Unknown |
| Models in bundled catalog | 534 across 9 provider categories | Claude family only | Subset chosen by Cursor |
| Bring your own API key / endpoint | ✅ Yes — keys stay on your machine | ✅ Anthropic key | ⚠️ Routed through Cursor backend |
| Open source | ✅ Apache-2.0 | ❌ Proprietary | ❌ Proprietary |
| Price | Free framework; pay only your chosen model provider | Subscription / API usage | Subscription |
| Run on top of Claude Code / Codex CLI | ✅ cc/* and codex/* namespaces |
N/A | ❌ |
| Messaging and communication channels | ✅ 23 third-party agents, including Slack, Gmail, Phone Control, SMS, and WhatsApp | ⚠️ Slack, mobile Remote Control, and research-preview channels for Telegram, Discord, and iMessage; no documented built-in Gmail, WhatsApp, phone-call, or SMS channel | ⚠️ Slack and Microsoft Teams Cloud Agent integrations; no documented built-in Gmail, WhatsApp, phone-call, or SMS channel |
What is in the Name
KISS Agent Framework is a deliberately small agent runtime organized around the KISS principle ("Keep it Simple, Stupid"). The name “Sorcar” pays homage to P. C. Sorcar, the legendary Bengali magician, evoking the idea of an agent that performs feats that appear magical yet are grounded in disciplined engineering. Note: Sorcar also means government in Bengali.
Installation
Full install from source
curl -fsSL https://raw.githubusercontent.com/ksenxx/kiss_ai/main/scripts/install.sh | bash
The installer targets macOS and Linux on x86_64, aarch64, and arm64. It installs or checks the tools needed to run KISS Sorcar and build/install the VS Code extension.
Python package / CLI install
If you only want the Python package and CLI entry points:
pipx install kiss-agent-framework
# or
uv tool install kiss-agent-framework
KISS Sorcar requires Python 3.13+.
Configure model access
Provide at least one model backend. You can use environment variables such as:
export ANTHROPIC_API_KEY=...
export OPENAI_API_KEY=...
export ZAI_API_KEY=...
export MOONSHOT_API_KEY=...
export TOGETHER_API_KEY=...
export OPENROUTER_API_KEY=...
export GEMINI_API_KEY=...
You can also configure a custom endpoint with --endpoint / -e and optional repeated --header Key:Value CLI flags.
VS Code Extension Installation
To install only the KISS Sorcar extension, open Visual Studio Code, search for KISS Sorcar in the extension marketplace, install it, and relaunch VS Code. Press ESC if you do not have a specific API key ready, but configure at least one model backend before running tasks.
CLI Interface
sorcar runs in two modes:
- Interactive (no
-t/--taskor-f/--file) — a Claude-Code-style REPL that connects as a thin terminal client to the localsorcar webdaemon. Chat-session control (new chat, resume by id, list history) and worktree merge/discard prompts are driven from slash commands. Each task is isolated in a git worktree by default. - Non-interactive (
-tor-fsupplied) — runs a plainSorcarAgentonce on the supplied task and exits. Worktree isolation and chat-session control are unavailable in this mode; display events are still streamed into the chat DB so the run is replayable in the chat webview.
# Launch the interactive Sorcar CLI, similar to Claude Code.
sorcar
# Run a one-shot task (non-interactive).
sorcar -t "What is 2435*234?"
# Use a specific model.
sorcar -m "claude-sonnet-4-6" -t "What is 2435*234?"
# Custom endpoint and headers for a local or self-hosted model.
sorcar -e "http://localhost:8000/v1" --header "Authorization:Bearer xxx" \
-t "Summarize this codebase."
# Cap spend at $2 and pin the working directory.
sorcar -b 2.0 -w "$HOME/projects/my-repo" -t "Refactor utils.py for clarity."
# Use the contents of a file as the task.
echo "Can you find the cheapest non-stop flight from SFO to JFK on June 15?" > prompt
sorcar -f prompt
# Disable browser/web tools (terminal-only mode).
sorcar --no-web -t "Lint and fix every Python file under src/."
# Disable parallel sub-agents for a deterministic single-thread run.
sorcar --no-parallel -t 'Run pytest and report which tests fail and why.'
# Ask Sorcar to use desktop/browser/messaging tools.
sorcar -t 'Can you send the message "Hello from Sorcar!" to ksen via the desktop Slack app?'
# Ask Sorcar to explain code.
sorcar -t 'Can you show me the detailed step-by-step workflow of gepa.py?'
# Manage MCP servers (see "sorcar mcp" subcommand below).
sorcar mcp list --ping
# Print the installed sorcar version and exit.
sorcar --version
CLI options
| Flag | Description |
|---|---|
-V, --version |
Print sorcar <version> (from kiss.__version__) and exit |
-t, --task |
Task description; switches to non-interactive mode |
-f, --file |
Path to a file whose contents are used as the task; switches to non-interactive mode |
-m, --model_name |
LLM model name; defaults to the best available model for the configured API keys |
-e, --endpoint |
Custom base URL for a local or self-hosted model |
--header |
Custom HTTP header in Key:Value form; may be repeated |
-b, --max_budget |
Maximum spend in USD for the run |
-w, --work_dir |
Working directory; defaults to the directory where sorcar is launched |
-v, --verbose |
Print Rich panels to the console (true by default; pass false for quiet mode) |
-p, --parallel / --no-parallel |
Enable/disable parallel sub-agents (enabled by default) |
--worktree / --no-worktree |
Interactive only. Isolate each task in a git worktree branch (enabled by default); use --no-worktree to run directly in the working tree |
--auto-commit / --no-auto-commit |
Interactive only. Auto-commit worktree changes when a task finishes (enabled by default); use --no-auto-commit to preserve the worktree for manual review |
--no-web |
Disable browser/web tools (terminal-only mode) |
--worktree / --no-worktree / --auto-commit / --no-auto-commit are rejected with exit 2 when combined with -t/-f, since the non-interactive path runs a bare SorcarAgent that does not implement them. Argparse prefix abbreviations are disabled, so each flag must be spelled out in full.
Interactive CLI features
The interactive CLI includes:
@file/folder mentions with ranked project-file completion.- Slash commands:
/help,/clear(alias/new),/resume,/model,/model list,/cost(aliases/usage,/context),/commands,/skills,/mcp,/autocommit,/voice(toggle wake-word voice chat), and/exit(alias/quit). - Custom Markdown slash commands loaded from
~/.kiss/commands,<project>/.kiss/commands,~/.claude/commands, and<project>/.claude/commands. - Agent Skills loaded from
~/.kiss/skills,<project>/.kiss/skills, Claude skill directories,.agents/skills, and bundled Sorcar skills. - MCP server discovery from
~/.kiss/mcp.json,<project>/.kiss/mcp.json, and<project>/.mcp.json. - VS Code "Tricks" button entries read from
~/.kiss/INJECTIONS.md(one per## Tricksection), seeded on install from the bundledsrc/kiss/INJECTIONS.md. Edit the file to customise the dropdown; remove it to regenerate from the bundled defaults. - VS Code welcome-screen sample-task chips are the concatenation of two
## Task-sectioned Markdown files: (1)~/.kiss/MY_TASK_TEMPLATES.md— your personal tasks, auto-created on first launch with the seed## Task\n\nHi!\nand never overwritten thereafter; (2) the bundledsrc/kiss/SAMPLE_TASKS.md— sample tasks shipped with the extension, read directly from the package so every upgrade delivers the latest chips. To customise your chips edit~/.kiss/MY_TASK_TEMPLATES.md; to reset it remove the file.
sorcar mcp subcommand
Manage Model-Context-Protocol servers used by Sorcar:
| Subcommand | Purpose |
|---|---|
sorcar mcp add <name> <cmd…> |
Register a stdio (default) or --transport http/sse server in --scope user (~/.kiss/mcp.json) or --scope project (<work_dir>/.kiss/mcp.json); supports --env KEY=VALUE and --header 'Key: Value' (repeatable). |
sorcar mcp list [--ping] |
List configured servers; --ping also connects and reports live status and tool counts. |
sorcar mcp get <name> |
Print one server's configuration as JSON. |
sorcar mcp remove <name> |
Delete a server from every writable config file. |
sorcar mcp auth <name> [--no-browser] |
Run the OAuth 2.1 browser flow (dynamic client registration + PKCE) and persist tokens under ~/.kiss/mcp_auth/. |
sorcar mcp logout <name> |
Delete a server's stored OAuth tokens. |
sorcar mcp debug <name> |
Connect and dump capabilities, tools (with input schemas and permission status), resources, and prompts. |
💬 Messaging & Third-Party Agents
KISS Sorcar includes 23 third-party messaging agents that can send and receive messages on your behalf:
BlueBubbles · Discord · Feishu · Gmail · Google Chat · iMessage · IRC · LINE · Matrix · Mattermost · Microsoft Teams · Nextcloud Talk · Nostr · Phone Control · Signal · Slack · SMS · Synology Chat · Telegram · Tlon · Twitch · WhatsApp · Zalo
It also ships a Govee smart-home CLI for controlling IoT lights (on/off, brightness, color, and color temperature) via the Govee Developer API.
These agents live in src/kiss/agents/third_party_agents/.
🤖 Models Supported
KISS Sorcar ships a catalog of 534 models across 9 provider categories, with built-in prices, context lengths, and capability flags (fc function calling, gen generation, emb embedding). The source of truth is src/kiss/core/models/MODEL_INFO.json.
| Provider category | Catalog entries |
|---|---|
| OpenAI | 84 |
| Anthropic | 14 |
| Gemini / Google | 25 |
| Together AI | 79 |
| Z.AI | 8 |
| Moonshot AI | 7 |
| OpenRouter | 305 |
Claude Code CLI (cc/*) |
3 |
Codex CLI (codex/*) |
9 |
Current catalog capability totals:
- 517 generation-capable models
- 365 function-calling-capable models
- 8 embedding models
Full model list:
OpenAI (84)
computer-use-previewcomputer-use-preview-2025-03-11gpt-3.5-turbogpt-3.5-turbo-0125gpt-3.5-turbo-1106gpt-3.5-turbo-16kgpt-4gpt-4-0613gpt-4-turbogpt-4-turbo-2024-04-09gpt-4.1gpt-4.1-2025-04-14gpt-4.1-minigpt-4.1-mini-2025-04-14gpt-4.1-nanogpt-4.1-nano-2025-04-14gpt-4ogpt-4o-2024-05-13gpt-4o-2024-08-06gpt-4o-2024-11-20gpt-4o-minigpt-4o-mini-2024-07-18gpt-4o-mini-search-previewgpt-4o-mini-search-preview-2025-03-11gpt-4o-search-previewgpt-4o-search-preview-2025-03-11gpt-5gpt-5-2025-08-07gpt-5-chat-latestgpt-5-minigpt-5-mini-2025-08-07gpt-5-nanogpt-5-nano-2025-08-07gpt-5.1gpt-5.1-2025-11-13gpt-5.1-chat-latestgpt-5.2gpt-5.2-2025-12-11gpt-5.2-chat-latestgpt-5.3-chat-latestgpt-5.4gpt-5.4-2026-03-05gpt-5.4-minigpt-5.4-mini-2026-03-17gpt-5.4-nanogpt-5.4-nano-2026-03-17gpt-5.5gpt-5.5-2026-04-23gpt-5.5-2026-04-23-xhighgpt-5.5-xhighgpt-5.6-lunagpt-5.6-luna-xhighgpt-5.6-solgpt-5.6-sol-xhighgpt-5.6-terragpt-5.6-terra-xhighgpt-audiogpt-audio-1.5gpt-audio-2025-08-28gpt-audio-minigpt-audio-mini-2025-10-06gpt-audio-mini-2025-12-15gpt-image-1gpt-image-1-minigpt-image-1.5gpt-image-2gpt-image-2-2026-04-21o1o1-2024-12-17o3o3-2025-04-16o3-deep-researcho3-deep-research-2025-06-26o3-minio3-mini-2025-01-31o4-minio4-mini-2025-04-16o4-mini-deep-researcho4-mini-deep-research-2025-06-26openai/gpt-oss-120bopenai/gpt-oss-20btext-embedding-3-largetext-embedding-3-smalltext-embedding-ada-002
Anthropic (14)
claude-fable-5claude-haiku-4-5claude-haiku-4-5-20251001claude-opus-4-1claude-opus-4-1-20250805claude-opus-4-5claude-opus-4-5-20251101claude-opus-4-6claude-opus-4-7claude-opus-4-8claude-sonnet-4-5claude-sonnet-4-5-20250929claude-sonnet-4-6claude-sonnet-5
Gemini / Google (25)
gemini-2.0-flashgemini-2.0-flash-001gemini-2.0-flash-litegemini-2.0-flash-lite-001gemini-2.5-flashgemini-2.5-flash-imagegemini-2.5-flash-litegemini-2.5-progemini-3-flash-previewgemini-3-pro-imagegemini-3-pro-previewgemini-3.1-flash-imagegemini-3.1-flash-litegemini-3.1-flash-lite-imagegemini-3.1-flash-lite-previewgemini-3.1-flash-tts-previewgemini-3.1-pro-previewgemini-3.5-flashgemini-embedding-001gemini-embedding-2gemini-embedding-2-previewgemini-omni-flash-previewgoogle/gemma-2-27b-itgoogle/gemma-3n-E4B-itgoogle/gemma-4-31B-it
Together AI (79)
arcee-ai/trinity-miniBAAI/bge-base-en-v1.5deepcogito/cogito-v1-preview-llama-70Bdeepcogito/cogito-v1-preview-llama-70B-Turbodeepcogito/cogito-v1-preview-llama-8Bdeepcogito/cogito-v1-preview-qwen-14Bdeepcogito/cogito-v1-preview-qwen-32Bdeepcogito/cogito-v2-1-671bdeepseek-ai/deepseek-coder-33b-instructdeepseek-ai/DeepSeek-R1deepseek-ai/DeepSeek-R1-0528deepseek-ai/DeepSeek-R1-0528-tputdeepseek-ai/DeepSeek-R1-Distill-Llama-70Bdeepseek-ai/DeepSeek-R1-Distill-Qwen-1.5Bdeepseek-ai/DeepSeek-R1-Distill-Qwen-14Bdeepseek-ai/DeepSeek-V3-0324deepseek-ai/DeepSeek-V3.1deepseek-ai/DeepSeek-V4-Proessentialai/rnj-1-instructintfloat/multilingual-e5-large-instructmeta-llama/Llama-3-70b-chat-hfmeta-llama/Llama-3-8b-chat-hfmeta-llama/Llama-3.1-405B-Instructmeta-llama/Llama-3.2-1B-Instructmeta-llama/Llama-3.2-3B-Instruct-Turbometa-llama/Llama-3.3-70B-Instruct-Turbometa-llama/Llama-3.3-70B-Instruct-Turbo-testmeta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8meta-llama/Llama-4-Scout-17B-16E-Instructmeta-llama/Meta-Llama-3-70B-Instruct-Turbometa-llama/Meta-Llama-3-8B-Instructmeta-llama/Meta-Llama-3-8B-Instruct-Litemeta-llama/Meta-Llama-3.1-70B-Instruct-Referencemeta-llama/Meta-Llama-3.1-70B-Instruct-Turbometa-llama/Meta-Llama-3.1-8B-Instruct-Referencemeta-llama/Meta-Llama-3.1-8B-Instruct-Turbomistralai/Ministral-3-14B-Instruct-2512mistralai/Mistral-7B-Instruct-v0.1mistralai/Mistral-7B-Instruct-v0.2mistralai/Mistral-7B-Instruct-v0.3mistralai/Mistral-Small-24B-Instruct-2501mistralai/Mixtral-8x7B-Instruct-v0.1moonshotai/Kimi-K2-Instructmoonshotai/Kimi-K2-Instruct-0905moonshotai/Kimi-K2-Thinkingmoonshotai/Kimi-K2.5moonshotai/Kimi-K2.6moonshotai/Kimi-K2.7-Codenvidia/Llama-3.1-Nemotron-70B-Instruct-HFnvidia/nemotron-3-ultra-550b-a55bnvidia/NVIDIA-Nemotron-Nano-9B-v2Qwen/Qwen2-1.5B-InstructQwen/Qwen2-VL-72B-InstructQwen/Qwen2.5-14B-InstructQwen/Qwen2.5-72B-InstructQwen/Qwen2.5-72B-Instruct-TurboQwen/Qwen2.5-7B-Instruct-TurboQwen/Qwen2.5-Coder-32B-InstructQwen/Qwen2.5-VL-72B-InstructQwen/Qwen3-235B-A22B-Instruct-2507-tputQwen/Qwen3-235B-A22B-Thinking-2507Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8Qwen/Qwen3-Coder-Next-FP8Qwen/Qwen3-Next-80B-A3B-InstructQwen/Qwen3-Next-80B-A3B-ThinkingQwen/Qwen3-VL-32B-InstructQwen/Qwen3-VL-8B-InstructQwen/Qwen3.5-397B-A17BQwen/Qwen3.5-9BQwen/Qwen3.6-PlusQwen/Qwen3.7-MaxQwen/Qwen3.7-PlusQwen/QwQ-32Bzai-org/GLM-4.5-Air-FP8zai-org/GLM-4.6zai-org/GLM-4.7zai-org/GLM-5zai-org/GLM-5.1zai-org/GLM-5.2
Z.AI (8)
glm-4-32b-0414-128kglm-4.5glm-4.5-airglm-4.5-airxglm-4.5-flashglm-4.5-xglm-4.6glm-4.7
Moonshot AI (7)
kimi-k2.5kimi-k2.6kimi-k2.7-codemoonshot-v1-128kmoonshot-v1-32kmoonshot-v1-8k
OpenRouter (305)
openrouter/ai21/jamba-large-1.7openrouter/aion-labs/aion-2.0openrouter/aion-labs/aion-3.0openrouter/aion-labs/aion-3.0-miniopenrouter/aion-labs/aion-rp-llama-3.1-8bopenrouter/allenai/olmo-3-32b-thinkopenrouter/amazon/nova-2-lite-v1openrouter/amazon/nova-lite-v1openrouter/amazon/nova-micro-v1openrouter/amazon/nova-premier-v1openrouter/amazon/nova-pro-v1openrouter/anthracite-org/magnum-v4-72bopenrouter/anthropic/claude-3-haikuopenrouter/anthropic/claude-3.7-sonnet:thinkingopenrouter/anthropic/claude-fable-5openrouter/anthropic/claude-haiku-4.5openrouter/anthropic/claude-opus-4openrouter/anthropic/claude-opus-4.1openrouter/anthropic/claude-opus-4.5openrouter/anthropic/claude-opus-4.6openrouter/anthropic/claude-opus-4.7openrouter/anthropic/claude-opus-4.7-fastopenrouter/anthropic/claude-opus-4.8openrouter/anthropic/claude-opus-4.8-fastopenrouter/anthropic/claude-sonnet-4openrouter/anthropic/claude-sonnet-4.5openrouter/anthropic/claude-sonnet-4.6openrouter/anthropic/claude-sonnet-5openrouter/arcee-ai/trinity-large-thinkingopenrouter/arcee-ai/virtuoso-largeopenrouter/baidu/ernie-4.5-vl-424b-a47bopenrouter/bytedance-seed/seed-1.6openrouter/bytedance-seed/seed-1.6-flashopenrouter/bytedance-seed/seed-2.0-liteopenrouter/bytedance-seed/seed-2.0-miniopenrouter/bytedance/ui-tars-1.5-7bopenrouter/cognitivecomputations/dolphin-mistral-24b-venice-editionopenrouter/cohere/command-aopenrouter/cohere/command-r-08-2024openrouter/cohere/command-r-plus-08-2024openrouter/cohere/command-r7b-12-2024openrouter/deepcogito/cogito-v2.1-671bopenrouter/deepseek/deepseek-chatopenrouter/deepseek/deepseek-chat-v3-0324openrouter/deepseek/deepseek-chat-v3.1openrouter/deepseek/deepseek-r1openrouter/deepseek/deepseek-r1-0528openrouter/deepseek/deepseek-r1-distill-llama-70bopenrouter/deepseek/deepseek-v3.1-terminusopenrouter/deepseek/deepseek-v3.2openrouter/deepseek/deepseek-v3.2-expopenrouter/deepseek/deepseek-v4-flashopenrouter/deepseek/deepseek-v4-proopenrouter/google/gemini-2.5-flashopenrouter/google/gemini-2.5-flash-imageopenrouter/google/gemini-2.5-flash-liteopenrouter/google/gemini-2.5-proopenrouter/google/gemini-2.5-pro-previewopenrouter/google/gemini-2.5-pro-preview-05-06openrouter/google/gemini-3-flash-previewopenrouter/google/gemini-3-pro-imageopenrouter/google/gemini-3-pro-image-previewopenrouter/google/gemini-3.1-flash-imageopenrouter/google/gemini-3.1-flash-image-previewopenrouter/google/gemini-3.1-flash-liteopenrouter/google/gemini-3.1-flash-lite-imageopenrouter/google/gemini-3.1-flash-lite-previewopenrouter/google/gemini-3.1-pro-previewopenrouter/google/gemini-3.1-pro-preview-customtoolsopenrouter/google/gemini-3.5-flashopenrouter/google/gemma-2-27b-itopenrouter/google/gemma-3-12b-itopenrouter/google/gemma-3-27b-itopenrouter/google/gemma-3-4b-itopenrouter/google/gemma-3n-e4b-itopenrouter/google/gemma-4-26b-a4b-itopenrouter/google/gemma-4-31b-itopenrouter/google/lyria-3-clip-previewopenrouter/google/lyria-3-pro-previewopenrouter/gryphe/mythomax-l2-13bopenrouter/ibm-granite/granite-4.0-h-microopenrouter/ibm-granite/granite-4.1-8bopenrouter/inception/mercury-2openrouter/inclusionai/ling-2.6-1topenrouter/inclusionai/ling-2.6-flashopenrouter/inclusionai/ring-2.6-1topenrouter/inflection/inflection-3-piopenrouter/inflection/inflection-3-productivityopenrouter/kwaipilot/kat-coder-air-v2.5openrouter/kwaipilot/kat-coder-pro-v2openrouter/kwaipilot/kat-coder-pro-v2.5openrouter/mancer/weaveropenrouter/meta-llama/llama-3.1-70b-instructopenrouter/meta-llama/llama-3.1-8b-instructopenrouter/meta-llama/llama-3.2-1b-instructopenrouter/meta-llama/llama-3.2-3b-instructopenrouter/meta-llama/llama-3.3-70b-instructopenrouter/meta-llama/llama-4-maverickopenrouter/meta-llama/llama-4-scoutopenrouter/meta-llama/llama-guard-4-12bopenrouter/meta/muse-spark-1.1openrouter/microsoft/phi-4openrouter/microsoft/wizardlm-2-8x22bopenrouter/mistralai/codestral-2508openrouter/mistralai/devstral-2512openrouter/mistralai/ministral-14b-2512openrouter/mistralai/ministral-3b-2512openrouter/mistralai/ministral-8b-2512openrouter/mistralai/mistral-largeopenrouter/mistralai/mistral-large-2407openrouter/mistralai/mistral-large-2512openrouter/mistralai/mistral-medium-3openrouter/mistralai/mistral-medium-3-5openrouter/mistralai/mistral-medium-3.1openrouter/mistralai/mistral-nemoopenrouter/mistralai/mistral-sabaopenrouter/mistralai/mistral-small-24b-instruct-2501openrouter/mistralai/mistral-small-2603openrouter/mistralai/mistral-small-3.1-24b-instructopenrouter/mistralai/mistral-small-3.2-24b-instructopenrouter/mistralai/mixtral-8x22b-instructopenrouter/mistralai/voxtral-small-24b-2507openrouter/moonshotai/kimi-k2openrouter/moonshotai/kimi-k2-0905openrouter/moonshotai/kimi-k2-thinkingopenrouter/moonshotai/kimi-k2.5openrouter/moonshotai/kimi-k2.6openrouter/moonshotai/kimi-k2.7-codeopenrouter/moonshotai/kimi-k3openrouter/morph/morph-v3-fastopenrouter/morph/morph-v3-largeopenrouter/nex-agi/nex-n2-miniopenrouter/nex-agi/nex-n2-proopenrouter/nousresearch/hermes-3-llama-3.1-405bopenrouter/nousresearch/hermes-3-llama-3.1-70bopenrouter/nousresearch/hermes-4-405bopenrouter/nousresearch/hermes-4-70bopenrouter/nvidia/nemotron-3-nano-30b-a3bopenrouter/nvidia/nemotron-3-super-120b-a12bopenrouter/nvidia/nemotron-3-ultra-550b-a55bopenrouter/openai/gpt-3.5-turboopenrouter/openai/gpt-3.5-turbo-0613openrouter/openai/gpt-3.5-turbo-16kopenrouter/openai/gpt-3.5-turbo-instructopenrouter/openai/gpt-4openrouter/openai/gpt-4-turboopenrouter/openai/gpt-4-turbo-previewopenrouter/openai/gpt-4.1openrouter/openai/gpt-4.1-miniopenrouter/openai/gpt-4.1-nanoopenrouter/openai/gpt-4oopenrouter/openai/gpt-4o-2024-05-13openrouter/openai/gpt-4o-2024-08-06openrouter/openai/gpt-4o-2024-11-20openrouter/openai/gpt-4o-miniopenrouter/openai/gpt-4o-mini-2024-07-18openrouter/openai/gpt-4o-mini-search-previewopenrouter/openai/gpt-4o-search-previewopenrouter/openai/gpt-4o:extendedopenrouter/openai/gpt-5openrouter/openai/gpt-5-chatopenrouter/openai/gpt-5-imageopenrouter/openai/gpt-5-image-miniopenrouter/openai/gpt-5-miniopenrouter/openai/gpt-5-nanoopenrouter/openai/gpt-5.1openrouter/openai/gpt-5.1-chatopenrouter/openai/gpt-5.2openrouter/openai/gpt-5.2-chatopenrouter/openai/gpt-5.3-chatopenrouter/openai/gpt-5.4openrouter/openai/gpt-5.4-image-2openrouter/openai/gpt-5.4-miniopenrouter/openai/gpt-5.4-nanoopenrouter/openai/gpt-5.5openrouter/openai/gpt-5.5-xhighopenrouter/openai/gpt-5.6-lunaopenrouter/openai/gpt-5.6-luna-xhighopenrouter/openai/gpt-5.6-solopenrouter/openai/gpt-5.6-sol-xhighopenrouter/openai/gpt-5.6-terraopenrouter/openai/gpt-5.6-terra-xhighopenrouter/openai/gpt-audioopenrouter/openai/gpt-audio-miniopenrouter/openai/gpt-chat-latestopenrouter/openai/gpt-oss-120bopenrouter/openai/gpt-oss-20bopenrouter/openai/gpt-oss-safeguard-20bopenrouter/openai/o1openrouter/openai/o1-proopenrouter/openai/o3openrouter/openai/o3-deep-researchopenrouter/openai/o3-miniopenrouter/openai/o3-mini-highopenrouter/openai/o3-proopenrouter/openai/o4-miniopenrouter/openai/o4-mini-deep-researchopenrouter/openai/o4-mini-highopenrouter/perceptron/perceptron-mk1openrouter/perplexity/sonaropenrouter/perplexity/sonar-deep-researchopenrouter/perplexity/sonar-proopenrouter/perplexity/sonar-pro-searchopenrouter/perplexity/sonar-reasoning-proopenrouter/poolside/laguna-m.1openrouter/poolside/laguna-xs-2.1openrouter/qwen/qwen-2.5-72b-instructopenrouter/qwen/qwen-2.5-7b-instructopenrouter/qwen/qwen-2.5-coder-32b-instructopenrouter/qwen/qwen-plusopenrouter/qwen/qwen-plus-2025-07-28openrouter/qwen/qwen-plus-2025-07-28:thinkingopenrouter/qwen/qwen2.5-vl-72b-instructopenrouter/qwen/qwen3-14bopenrouter/qwen/qwen3-235b-a22bopenrouter/qwen/qwen3-235b-a22b-2507openrouter/qwen/qwen3-235b-a22b-thinking-2507openrouter/qwen/qwen3-30b-a3bopenrouter/qwen/qwen3-30b-a3b-instruct-2507openrouter/qwen/qwen3-30b-a3b-thinking-2507openrouter/qwen/qwen3-32bopenrouter/qwen/qwen3-8bopenrouter/qwen/qwen3-coderopenrouter/qwen/qwen3-coder-30b-a3b-instructopenrouter/qwen/qwen3-coder-flashopenrouter/qwen/qwen3-coder-nextopenrouter/qwen/qwen3-coder-plusopenrouter/qwen/qwen3-maxopenrouter/qwen/qwen3-max-thinkingopenrouter/qwen/qwen3-next-80b-a3b-instructopenrouter/qwen/qwen3-next-80b-a3b-thinkingopenrouter/qwen/qwen3-vl-235b-a22b-instructopenrouter/qwen/qwen3-vl-235b-a22b-thinkingopenrouter/qwen/qwen3-vl-30b-a3b-instructopenrouter/qwen/qwen3-vl-30b-a3b-thinkingopenrouter/qwen/qwen3-vl-32b-instructopenrouter/qwen/qwen3-vl-8b-instructopenrouter/qwen/qwen3-vl-8b-thinkingopenrouter/qwen/qwen3.5-122b-a10bopenrouter/qwen/qwen3.5-27bopenrouter/qwen/qwen3.5-35b-a3bopenrouter/qwen/qwen3.5-397b-a17bopenrouter/qwen/qwen3.5-9bopenrouter/qwen/qwen3.5-flash-02-23openrouter/qwen/qwen3.5-plus-02-15openrouter/qwen/qwen3.5-plus-20260420openrouter/qwen/qwen3.6-27bopenrouter/qwen/qwen3.6-35b-a3bopenrouter/qwen/qwen3.6-flashopenrouter/qwen/qwen3.6-max-previewopenrouter/qwen/qwen3.6-plusopenrouter/qwen/qwen3.7-maxopenrouter/qwen/qwen3.7-plusopenrouter/rekaai/reka-edgeopenrouter/rekaai/reka-flash-3openrouter/relace/relace-apply-3openrouter/relace/relace-searchopenrouter/sakana/fugu-ultraopenrouter/sao10k/l3-lunaris-8bopenrouter/sao10k/l3.1-euryale-70bopenrouter/sao10k/l3.3-euryale-70bopenrouter/stepfun/step-3.5-flashopenrouter/stepfun/step-3.7-flashopenrouter/tencent/hunyuan-a13b-instructopenrouter/tencent/hy3openrouter/tencent/hy3-previewopenrouter/thedrummer/cydonia-24b-v4.1openrouter/thedrummer/rocinante-12bopenrouter/thedrummer/skyfall-36b-v2openrouter/thedrummer/unslopnemo-12bopenrouter/thinkingmachines/inklingopenrouter/undi95/remm-slerp-l2-13bopenrouter/upstage/solar-pro-3openrouter/writer/palmyra-x5openrouter/x-ai/grok-4.20openrouter/x-ai/grok-4.20-multi-agentopenrouter/x-ai/grok-4.3openrouter/x-ai/grok-4.5openrouter/x-ai/grok-build-0.1openrouter/xiaomi/mimo-v2.5openrouter/xiaomi/mimo-v2.5-proopenrouter/z-ai/glm-4.5openrouter/z-ai/glm-4.5-airopenrouter/z-ai/glm-4.5vopenrouter/z-ai/glm-4.6openrouter/z-ai/glm-4.6vopenrouter/z-ai/glm-4.7openrouter/z-ai/glm-4.7-flashopenrouter/z-ai/glm-5openrouter/z-ai/glm-5-turboopenrouter/z-ai/glm-5.1openrouter/z-ai/glm-5.2openrouter/z-ai/glm-5v-turboopenrouter/~anthropic/claude-fable-latestopenrouter/~anthropic/claude-haiku-latestopenrouter/~anthropic/claude-opus-latestopenrouter/~anthropic/claude-sonnet-latestopenrouter/~google/gemini-flash-latestopenrouter/~google/gemini-pro-latestopenrouter/~moonshotai/kimi-latestopenrouter/~openai/gpt-latestopenrouter/~openai/gpt-latest-xhighopenrouter/~openai/gpt-mini-latestopenrouter/~x-ai/grok-latest
Claude Code CLI (cc/*) (3)
cc/haikucc/opuscc/sonnet
Codex CLI (codex/*) (9)
codex/codex-auto-reviewcodex/defaultcodex/gpt-5.2codex/gpt-5.4codex/gpt-5.4-minicodex/gpt-5.5codex/gpt-5.6-lunacodex/gpt-5.6-solcodex/gpt-5.6-terra
🤗 Contributing
Contributions in the form of issues are welcome. KISS Sorcar should be able to help implement and review them.
📄 License
Apache-2.0. See LICENSE.
📚 Citation
If you use KISS Sorcar in your research, please cite:
@misc{sen2026kisssorcar,
title = {KISS Sorcar: A Stupidly-Simple General-Purpose and Software Engineering AI Assistant},
author = {Sen, Koushik},
year = {2026},
eprint = {2604.23822},
archivePrefix = {arXiv},
primaryClass = {cs.SE},
url = {https://arxiv.org/abs/2604.23822}
}
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file kiss_agent_framework-2026.7.29.tar.gz.
File metadata
- Download URL: kiss_agent_framework-2026.7.29.tar.gz
- Upload date:
- Size: 6.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fafea34e9b406e1a9bc38167dddcd994ee8078d9cfc0fcb12228205983bbec61
|
|
| MD5 |
20acaf1f3e7a88c85ee00d4fdc294129
|
|
| BLAKE2b-256 |
f26f2daa3479da12cd862e8b3c5eaa7c18461728fb1236e3930e876b202ea861
|
File details
Details for the file kiss_agent_framework-2026.7.29-py3-none-any.whl.
File metadata
- Download URL: kiss_agent_framework-2026.7.29-py3-none-any.whl
- Upload date:
- Size: 7.3 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
98ca99ca697a07d34bfb6d96bf9b4cb4fcd50024c6f879ecb33129c09c439e40
|
|
| MD5 |
c723617aff6738f44948d889961c625e
|
|
| BLAKE2b-256 |
59f896c2be313255352d474a4ff4cf41f98608e83b346ea782b48c0ce725046b
|
