Skip to main content

KISS Framework

Version License Python Website arXiv

"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 and a browser/mobile web app, both served by a local daemon, and offers a Python client API for scripting tasks. 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 demo

🆚 KISS Sorcar vs Claude Code vs Cursor

Capability KISS Sorcar Claude Code Cursor
Interfaces VS Code extension + web/mobile app + Python API 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 ~3000 Unknown Unknown
Models in bundled catalog 622 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 ✅ 32 third-party channel agents, including Slack, Gmail, Email (IMAP/SMTP), Phone Control, SMS, WhatsApp, and Home Assistant ⚠️ 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
Scheduled automations ✅ natural-language cron agent
Wake word for voice interaction Sorcar N/A N/A

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 install

If you only want the Python package (the kiss-web daemon, the Python client API, and the messaging-agent 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 set API keys, a custom model endpoint, and custom HTTP headers in the Settings panel of the VS Code extension or web app.

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.

Using KISS Sorcar

KISS Sorcar has three client interfaces, all served by one local daemon: the VS Code extension, the remote web/mobile app, and the Python client API.

VS Code extension and web/mobile app

Open the KISS Sorcar sidebar in VS Code (or the remote web app in a browser) and type or speak your task. The chat interface provides:

  • @ file/folder mentions with ranked project-file completion.
  • Per-task git worktree isolation — worktrees are pre-warmed in the background for fast task start, with auto-commit and merge on success, or an interactive merge/discard prompt — toggle both in the Settings panel.
  • A model picker, per-task budget caps, chat history with resume (filtered to the current workspace by default), and an agent dashboard (burger menu, bottom-left).
  • Wake-word voice chat ("sorcar, …") via the mic button, including steering a running agent by voice.
  • Live steering: inject a message into a running agent, or switch its model mid-run.
  • Tab mirroring — every VS Code window and web client opened on the same workspace shows the same tabs with the same contents; the tab bar is scoped to the client's workspace directory, and sub-agents dispatched with run_agent open their own tab in the calling workspace.
  • Scheduled automations: ask in plain language ("every weekday at 9am, summarize my unread Slack messages") and the built-in cron agent creates, lists, pauses, resumes, or removes the schedule. A job runs an unattended LLM task or a plain shell command and can deliver its result to any authenticated messaging channel (e.g. telegram:123456, email:user@example.com).

The remote web app is the same interface served over a cloudflared tunnel: copy the URL and password from the Settings panel and open it on any device.

The kiss-web daemon

The kiss-web daemon hosts all agents, chat sessions, and the web app, and services every client command — including config reads/writes, default-model lookup, and the wake-word listener — over its socket. The VS Code extension starts it automatically; you can also manage it yourself:

# Start the daemon (serves the web app and the extension).
kiss-web

# Pin the daemon's working directory.
kiss-web --workdir "$HOME/projects/my-repo"

# Print the active remote (cloudflared) URL and exit.
kiss-web --url

Python client API

Any Python process can run a task on the daemon with kiss.server.sorcar.run and block until it finishes:

from kiss.server import sorcar

result = sorcar.run("Summarize README.md", work_dir="/path/to/repo")
print(result.text, result.success, result.cost, result.tokens, result.steps)

# Continue the same chat (the agent sees the prior task as context):
follow_up = sorcar.run("Now fix the typos you found", chat_id=result.chat_id)

run() accepts keyword options mirroring the chat interface — model, work_dir, chat_id, use_worktree, auto_commit, max_budget, model_config (custom endpoint/headers), web_tools, is_parallel, timeout, sock_path (daemon socket override) — plus options to customize the agent itself:

  • tools="/path/to/my_tools.py" — a Python file whose get_tools() function returns the functions the daemon registers as extra agent tools. The functions are never serialized: only the path travels over the socket, and the daemon imports the file, calls get_tools(), and runs the tools in its own process.
  • system_prompt — replace the default system prompt for the run (and its sub-agents); append_to_system_prompt / append_to_prompt — append text to the system prompt or task prompt instead of replacing them.
  • append_basic_tools=False — restrict the agent to finish plus your tools file, dropping the built-in toolset.
  • extension_agent_path — run a full extension agent, a Python file that can also define get_prompt(), get_system_prompt(), and other overrides; see the authoring guide in src/kiss/server/README.md.

Skills, MCP servers, and customization

  • 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; OAuth tokens are persisted under ~/.kiss/mcp_auth/.
  • "Tricks" button entries read from ~/.kiss/INJECTIONS.md (one per ## Trick section), seeded on install from the bundled src/kiss/INJECTIONS.md. Edit the file to customise the dropdown; remove it to regenerate from the bundled defaults.
  • 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!\n and never overwritten thereafter; (2) the bundled src/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.

💬 Messaging & Third-Party Agents

KISS Sorcar includes 32 third-party channel agents that act on messaging services, mailboxes, and devices on your behalf:

BlueBubbles · DingTalk · Discord · Email (IMAP/SMTP) · Feishu · Gmail · Google Chat · Home Assistant · iMessage · IRC · LINE · Matrix · Mattermost · Microsoft Teams · Nextcloud Talk · Nostr · ntfy · Phone Control · QQ · Signal · SimpleX · Slack · SMS · Synology Chat · Telegram · Tlon · Twitch · Webhook · WeCom · WeiXin · WhatsApp · Zalo

In a chat task, just say what you want ("send 'running late' to Alice on WhatsApp") — Sorcar dispatches the matching channel agent through its run_agent tool. Each channel also has its own CLI entry point (kiss-slack, kiss-gmail, kiss-whatsapp, …) for running channel tasks directly from the shell.

Two infrastructure agents round out the set: an A2A agent (kiss-a2a) exposing Sorcar over the agent-to-agent protocol, and an OpenAI-compatible server (kiss-oai) that serves Sorcar behind an OpenAI-style HTTP API. 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 622 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 105
Anthropic 13
Gemini / Google 25
Together AI 88
Z.AI 8
Moonshot AI 10
OpenRouter 351
Claude Code CLI (cc/*) 13
Codex CLI (codex/*) 9

Current catalog capability totals:

  • 603 generation-capable models
  • 444 function-calling-capable models
  • 10 embedding models

Full model list:

OpenAI (105)
  • computer-use-preview
  • computer-use-preview-2025-03-11
  • gpt-3.5-turbo
  • gpt-3.5-turbo-0125
  • gpt-3.5-turbo-1106
  • gpt-3.5-turbo-16k
  • gpt-4
  • gpt-4-0613
  • gpt-4-turbo
  • gpt-4-turbo-2024-04-09
  • gpt-4.1
  • gpt-4.1-2025-04-14
  • gpt-4.1-mini
  • gpt-4.1-mini-2025-04-14
  • gpt-4.1-nano
  • gpt-4.1-nano-2025-04-14
  • gpt-4o
  • gpt-4o-2024-05-13
  • gpt-4o-2024-08-06
  • gpt-4o-2024-11-20
  • gpt-4o-mini
  • gpt-4o-mini-2024-07-18
  • gpt-4o-mini-search-preview
  • gpt-4o-mini-search-preview-2025-03-11
  • gpt-4o-search-preview
  • gpt-4o-search-preview-2025-03-11
  • gpt-5
  • gpt-5-2025-08-07
  • gpt-5-chat-latest
  • gpt-5-mini
  • gpt-5-mini-2025-08-07
  • gpt-5-nano
  • gpt-5-nano-2025-08-07
  • gpt-5.1
  • gpt-5.1-2025-11-13
  • gpt-5.1-chat-latest
  • gpt-5.2
  • gpt-5.2-2025-12-11
  • gpt-5.2-chat-latest
  • gpt-5.3-chat-latest
  • gpt-5.4
  • gpt-5.4-2026-03-05
  • gpt-5.4-mini
  • gpt-5.4-mini-2026-03-17
  • gpt-5.4-nano
  • gpt-5.4-nano-2026-03-17
  • gpt-5.5
  • gpt-5.5-2026-04-23
  • gpt-5.5-2026-04-23-high
  • gpt-5.5-2026-04-23-low
  • gpt-5.5-2026-04-23-medium
  • gpt-5.5-2026-04-23-xhigh
  • gpt-5.5-high
  • gpt-5.5-low
  • gpt-5.5-medium
  • gpt-5.5-xhigh
  • gpt-5.6-luna
  • gpt-5.6-luna-high
  • gpt-5.6-luna-low
  • gpt-5.6-luna-medium
  • gpt-5.6-luna-xhigh
  • gpt-5.6-sol
  • gpt-5.6-sol-high
  • gpt-5.6-sol-low
  • gpt-5.6-sol-medium
  • gpt-5.6-sol-xhigh
  • gpt-5.6-terra
  • gpt-5.6-terra-high
  • gpt-5.6-terra-low
  • gpt-5.6-terra-medium
  • gpt-5.6-terra-xhigh
  • gpt-audio
  • gpt-audio-1.5
  • gpt-audio-2025-08-28
  • gpt-audio-mini
  • gpt-audio-mini-2025-10-06
  • gpt-audio-mini-2025-12-15
  • gpt-image-1
  • gpt-image-1-mini
  • gpt-image-1.5
  • gpt-image-2
  • gpt-image-2-2026-04-21
  • o1
  • o1-2024-12-17
  • o3
  • o3-2025-04-16
  • o3-deep-research
  • o3-deep-research-2025-06-26
  • o3-mini
  • o3-mini-2025-01-31
  • o4-mini
  • o4-mini-2025-04-16
  • o4-mini-deep-research
  • o4-mini-deep-research-2025-06-26
  • openai/gpt-oss-120b
  • openai/gpt-oss-120b-high
  • openai/gpt-oss-120b-low
  • openai/gpt-oss-120b-medium
  • openai/gpt-oss-20b
  • openai/gpt-oss-20b-high
  • openai/gpt-oss-20b-low
  • openai/gpt-oss-20b-medium
  • text-embedding-3-large
  • text-embedding-3-small
  • text-embedding-ada-002
Anthropic (13)
  • claude-fable-5
  • claude-haiku-4-5
  • claude-haiku-4-5-20251001
  • claude-opus-4-5
  • claude-opus-4-5-20251101
  • claude-opus-4-6
  • claude-opus-4-7
  • claude-opus-4-8
  • claude-opus-5
  • claude-sonnet-4-5
  • claude-sonnet-4-5-20250929
  • claude-sonnet-4-6
  • claude-sonnet-5
Gemini / Google (25)
  • gemini-2.0-flash
  • gemini-2.0-flash-001
  • gemini-2.0-flash-lite
  • gemini-2.0-flash-lite-001
  • gemini-2.5-flash
  • gemini-2.5-flash-image
  • gemini-2.5-flash-lite
  • gemini-2.5-pro
  • gemini-3-flash-preview
  • gemini-3-pro-image
  • gemini-3-pro-preview
  • gemini-3.1-flash-image
  • gemini-3.1-flash-lite
  • gemini-3.1-flash-lite-image
  • gemini-3.1-flash-lite-preview
  • gemini-3.1-flash-tts-preview
  • gemini-3.1-pro-preview
  • gemini-3.5-flash
  • gemini-3.5-flash-lite
  • gemini-3.6-flash
  • gemini-embedding-001
  • gemini-embedding-2
  • gemini-embedding-2-preview
  • gemini-omni-flash-preview
  • google/gemma-2-27b-it
  • google/gemma-3n-E4B-it
  • google/gemma-4-31B-it
Together AI (88)
  • BAAI/bge-base-en-v1.5
  • Qwen/QwQ-32B
  • Qwen/Qwen2-1.5B-Instruct
  • Qwen/Qwen2-VL-72B-Instruct
  • Qwen/Qwen2.5-14B-Instruct
  • Qwen/Qwen2.5-72B-Instruct
  • Qwen/Qwen2.5-72B-Instruct-Turbo
  • Qwen/Qwen2.5-7B-Instruct-Turbo
  • Qwen/Qwen2.5-Coder-32B-Instruct
  • Qwen/Qwen2.5-VL-72B-Instruct
  • Qwen/Qwen3-235B-A22B-Instruct-2507-tput
  • Qwen/Qwen3-235B-A22B-Thinking-2507
  • Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8
  • Qwen/Qwen3-Coder-Next-FP8
  • Qwen/Qwen3-Next-80B-A3B-Instruct
  • Qwen/Qwen3-Next-80B-A3B-Thinking
  • Qwen/Qwen3-VL-32B-Instruct
  • Qwen/Qwen3-VL-8B-Instruct
  • Qwen/Qwen3.5-397B-A17B
  • Qwen/Qwen3.5-9B
  • Qwen/Qwen3.6-Plus
  • Qwen/Qwen3.7-Max
  • Qwen/Qwen3.7-Plus
  • arcee-ai/trinity-mini
  • deepcogito/cogito-v1-preview-llama-70B
  • deepcogito/cogito-v1-preview-llama-70B-Turbo
  • deepcogito/cogito-v1-preview-llama-8B
  • deepcogito/cogito-v1-preview-qwen-14B
  • deepcogito/cogito-v1-preview-qwen-32B
  • deepcogito/cogito-v2-1-671b
  • deepseek-ai/DeepSeek-R1
  • deepseek-ai/DeepSeek-R1-0528
  • deepseek-ai/DeepSeek-R1-0528-tput
  • deepseek-ai/DeepSeek-R1-Distill-Llama-70B
  • deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B
  • deepseek-ai/DeepSeek-R1-Distill-Qwen-14B
  • deepseek-ai/DeepSeek-V3-0324
  • deepseek-ai/DeepSeek-V3.1
  • deepseek-ai/DeepSeek-V4-Flash-0731
  • deepseek-ai/DeepSeek-V4-Pro
  • deepseek-ai/deepseek-coder-33b-instruct
  • essentialai/rnj-1-instruct
  • intfloat/multilingual-e5-large-instruct
  • meta-llama/Llama-3-70b-chat-hf
  • meta-llama/Llama-3-8b-chat-hf
  • meta-llama/Llama-3.1-405B-Instruct
  • meta-llama/Llama-3.2-1B-Instruct
  • meta-llama/Llama-3.2-3B-Instruct-Turbo
  • meta-llama/Llama-3.3-70B-Instruct-Turbo
  • meta-llama/Llama-3.3-70B-Instruct-Turbo-test
  • meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8
  • meta-llama/Llama-4-Scout-17B-16E-Instruct
  • meta-llama/Meta-Llama-3-70B-Instruct-Turbo
  • meta-llama/Meta-Llama-3-8B-Instruct
  • meta-llama/Meta-Llama-3-8B-Instruct-Lite
  • meta-llama/Meta-Llama-3.1-70B-Instruct-Reference
  • meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo
  • meta-llama/Meta-Llama-3.1-8B-Instruct-Reference
  • meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo
  • mistralai/Ministral-3-14B-Instruct-2512
  • mistralai/Mistral-7B-Instruct-v0.1
  • mistralai/Mistral-7B-Instruct-v0.2
  • mistralai/Mistral-7B-Instruct-v0.3
  • mistralai/Mistral-Small-24B-Instruct-2501
  • mistralai/Mixtral-8x7B-Instruct-v0.1
  • moonshotai/Kimi-K2-Instruct
  • moonshotai/Kimi-K2-Instruct-0905
  • moonshotai/Kimi-K2-Thinking
  • moonshotai/Kimi-K2.5
  • moonshotai/Kimi-K2.6
  • moonshotai/Kimi-K2.7-Code
  • moonshotai/Kimi-K3
  • moonshotai/Kimi-K3-high
  • moonshotai/Kimi-K3-low
  • moonshotai/Kimi-K3-max
  • nvidia/Llama-3.1-Nemotron-70B-Instruct-HF
  • nvidia/NVIDIA-Nemotron-Nano-9B-v2
  • nvidia/nemotron-3-ultra-550b-a55b
  • zai-org/GLM-4.5-Air-FP8
  • zai-org/GLM-4.6
  • zai-org/GLM-4.7
  • zai-org/GLM-5
  • zai-org/GLM-5.1
  • zai-org/GLM-5.2
  • zai-org/GLM-5.2-high
  • zai-org/GLM-5.2-max
Z.AI (8)
  • glm-4-32b-0414-128k
  • glm-4.5
  • glm-4.5-air
  • glm-4.5-airx
  • glm-4.5-flash
  • glm-4.5-x
  • glm-4.6
  • glm-4.7
Moonshot AI (10)
  • kimi-k2.5
  • kimi-k2.6
  • kimi-k2.7-code
  • kimi-k3
  • kimi-k3-high
  • kimi-k3-low
  • kimi-k3-max
  • moonshot-v1-128k
  • moonshot-v1-32k
  • moonshot-v1-8k
OpenRouter (351)
  • openrouter/ai21/jamba-large-1.7
  • openrouter/aion-labs/aion-2.0
  • openrouter/aion-labs/aion-3.0
  • openrouter/aion-labs/aion-3.0-mini
  • openrouter/aion-labs/aion-rp-llama-3.1-8b
  • openrouter/allenai/olmo-3-32b-think
  • openrouter/amazon/nova-2-lite-v1
  • openrouter/amazon/nova-lite-v1
  • openrouter/amazon/nova-micro-v1
  • openrouter/amazon/nova-premier-v1
  • openrouter/amazon/nova-pro-v1
  • openrouter/anthracite-org/magnum-v4-72b
  • openrouter/anthropic/claude-3-haiku
  • openrouter/anthropic/claude-3.7-sonnet:thinking
  • openrouter/anthropic/claude-fable-5
  • openrouter/anthropic/claude-haiku-4.5
  • openrouter/anthropic/claude-opus-4
  • openrouter/anthropic/claude-opus-4.1
  • openrouter/anthropic/claude-opus-4.5
  • openrouter/anthropic/claude-opus-4.6
  • openrouter/anthropic/claude-opus-4.7
  • openrouter/anthropic/claude-opus-4.7-fast
  • openrouter/anthropic/claude-opus-4.8
  • openrouter/anthropic/claude-opus-4.8-fast
  • openrouter/anthropic/claude-opus-5
  • openrouter/anthropic/claude-opus-5-fast
  • openrouter/anthropic/claude-sonnet-4
  • openrouter/anthropic/claude-sonnet-4.5
  • openrouter/anthropic/claude-sonnet-4.6
  • openrouter/anthropic/claude-sonnet-5
  • openrouter/arcee-ai/trinity-large-thinking
  • openrouter/arcee-ai/virtuoso-large
  • openrouter/baidu/ernie-4.5-vl-424b-a47b
  • openrouter/bytedance-seed/seed-1.6
  • openrouter/bytedance-seed/seed-1.6-flash
  • openrouter/bytedance-seed/seed-2.0-lite
  • openrouter/bytedance-seed/seed-2.0-mini
  • openrouter/bytedance/ui-tars-1.5-7b
  • openrouter/cognitivecomputations/dolphin-mistral-24b-venice-edition
  • openrouter/cohere/command-a
  • openrouter/cohere/command-r-08-2024
  • openrouter/cohere/command-r-plus-08-2024
  • openrouter/cohere/command-r7b-12-2024
  • openrouter/deepcogito/cogito-v2.1-671b
  • openrouter/deepseek/deepseek-chat
  • openrouter/deepseek/deepseek-chat-v3-0324
  • openrouter/deepseek/deepseek-chat-v3.1
  • openrouter/deepseek/deepseek-r1
  • openrouter/deepseek/deepseek-r1-0528
  • openrouter/deepseek/deepseek-r1-distill-llama-70b
  • openrouter/deepseek/deepseek-v3.1-terminus
  • openrouter/deepseek/deepseek-v3.2
  • openrouter/deepseek/deepseek-v3.2-exp
  • openrouter/deepseek/deepseek-v4-flash
  • openrouter/deepseek/deepseek-v4-flash-0731
  • openrouter/deepseek/deepseek-v4-pro
  • openrouter/google/gemini-2.5-flash
  • openrouter/google/gemini-2.5-flash-image
  • openrouter/google/gemini-2.5-flash-lite
  • openrouter/google/gemini-2.5-pro
  • openrouter/google/gemini-2.5-pro-preview
  • openrouter/google/gemini-2.5-pro-preview-05-06
  • openrouter/google/gemini-3-flash-preview
  • openrouter/google/gemini-3-pro-image
  • openrouter/google/gemini-3-pro-image-preview
  • openrouter/google/gemini-3.1-flash-image
  • openrouter/google/gemini-3.1-flash-image-preview
  • openrouter/google/gemini-3.1-flash-lite
  • openrouter/google/gemini-3.1-flash-lite-image
  • openrouter/google/gemini-3.1-flash-lite-preview
  • openrouter/google/gemini-3.1-pro-preview
  • openrouter/google/gemini-3.1-pro-preview-customtools
  • openrouter/google/gemini-3.5-flash
  • openrouter/google/gemini-3.5-flash-lite
  • openrouter/google/gemini-3.6-flash
  • openrouter/google/gemma-2-27b-it
  • openrouter/google/gemma-3-12b-it
  • openrouter/google/gemma-3-27b-it
  • openrouter/google/gemma-3-4b-it
  • openrouter/google/gemma-3n-e4b-it
  • openrouter/google/gemma-4-26b-a4b-it
  • openrouter/google/gemma-4-31b-it
  • openrouter/google/lyria-3-clip-preview
  • openrouter/google/lyria-3-pro-preview
  • openrouter/gryphe/mythomax-l2-13b
  • openrouter/ibm-granite/granite-4.0-h-micro
  • openrouter/ibm-granite/granite-4.1-8b
  • openrouter/inception/mercury-2
  • openrouter/inclusionai/ling-2.6-1t
  • openrouter/inclusionai/ling-2.6-flash
  • openrouter/inclusionai/ling-3.0-flash
  • openrouter/inclusionai/ring-2.6-1t
  • openrouter/kwaipilot/kat-coder-air-v2.5
  • openrouter/kwaipilot/kat-coder-pro-v2
  • openrouter/kwaipilot/kat-coder-pro-v2.5
  • openrouter/mancer/weaver
  • openrouter/meituan/longcat-2.0
  • openrouter/meta-llama/llama-3.1-70b-instruct
  • openrouter/meta-llama/llama-3.1-8b-instruct
  • openrouter/meta-llama/llama-3.2-1b-instruct
  • openrouter/meta-llama/llama-3.2-3b-instruct
  • openrouter/meta-llama/llama-3.3-70b-instruct
  • openrouter/meta-llama/llama-4-maverick
  • openrouter/meta-llama/llama-4-scout
  • openrouter/meta-llama/llama-guard-4-12b
  • openrouter/meta/muse-spark-1.1
  • openrouter/meta/muse-spark-1.2
  • openrouter/microsoft/phi-4
  • openrouter/microsoft/wizardlm-2-8x22b
  • openrouter/mistralai/codestral-2508
  • openrouter/mistralai/ministral-14b-2512
  • openrouter/mistralai/ministral-3b-2512
  • openrouter/mistralai/ministral-8b-2512
  • openrouter/mistralai/mistral-large
  • openrouter/mistralai/mistral-large-2407
  • openrouter/mistralai/mistral-large-2512
  • openrouter/mistralai/mistral-medium-3
  • openrouter/mistralai/mistral-medium-3-5
  • openrouter/mistralai/mistral-medium-3.1
  • openrouter/mistralai/mistral-nemo
  • openrouter/mistralai/mistral-saba
  • openrouter/mistralai/mistral-small-24b-instruct-2501
  • openrouter/mistralai/mistral-small-2603
  • openrouter/mistralai/mistral-small-3.1-24b-instruct
  • openrouter/mistralai/mistral-small-3.2-24b-instruct
  • openrouter/mistralai/mixtral-8x22b-instruct
  • openrouter/mistralai/voxtral-small-24b-2507
  • openrouter/moonshotai/kimi-k2
  • openrouter/moonshotai/kimi-k2-0905
  • openrouter/moonshotai/kimi-k2-thinking
  • openrouter/moonshotai/kimi-k2.5
  • openrouter/moonshotai/kimi-k2.6
  • openrouter/moonshotai/kimi-k2.7-code
  • openrouter/moonshotai/kimi-k3
  • openrouter/moonshotai/kimi-k3-high
  • openrouter/moonshotai/kimi-k3-low
  • openrouter/moonshotai/kimi-k3-max
  • openrouter/morph/morph-v3-fast
  • openrouter/morph/morph-v3-large
  • openrouter/nex-agi/nex-n2-mini
  • openrouter/nex-agi/nex-n2-pro
  • openrouter/nousresearch/hermes-3-llama-3.1-405b
  • openrouter/nousresearch/hermes-3-llama-3.1-70b
  • openrouter/nousresearch/hermes-4-405b
  • openrouter/nousresearch/hermes-4-70b
  • openrouter/nvidia/nemotron-3-nano-30b-a3b
  • openrouter/nvidia/nemotron-3-super-120b-a12b
  • openrouter/nvidia/nemotron-3-ultra-550b-a55b
  • openrouter/openai/gpt-3.5-turbo
  • openrouter/openai/gpt-3.5-turbo-0613
  • openrouter/openai/gpt-3.5-turbo-16k
  • openrouter/openai/gpt-3.5-turbo-instruct
  • openrouter/openai/gpt-4
  • openrouter/openai/gpt-4-turbo
  • openrouter/openai/gpt-4-turbo-preview
  • openrouter/openai/gpt-4.1
  • openrouter/openai/gpt-4.1-mini
  • openrouter/openai/gpt-4.1-nano
  • openrouter/openai/gpt-4o
  • openrouter/openai/gpt-4o-2024-05-13
  • openrouter/openai/gpt-4o-2024-08-06
  • openrouter/openai/gpt-4o-2024-11-20
  • openrouter/openai/gpt-4o-mini
  • openrouter/openai/gpt-4o-mini-2024-07-18
  • openrouter/openai/gpt-4o:extended
  • openrouter/openai/gpt-5
  • openrouter/openai/gpt-5-image
  • openrouter/openai/gpt-5-image-mini
  • openrouter/openai/gpt-5-mini
  • openrouter/openai/gpt-5-nano
  • openrouter/openai/gpt-5.1
  • openrouter/openai/gpt-5.2
  • openrouter/openai/gpt-5.2-chat
  • openrouter/openai/gpt-5.3-chat
  • openrouter/openai/gpt-5.4
  • openrouter/openai/gpt-5.4-image-2
  • openrouter/openai/gpt-5.4-mini
  • openrouter/openai/gpt-5.4-nano
  • openrouter/openai/gpt-5.5
  • openrouter/openai/gpt-5.5-high
  • openrouter/openai/gpt-5.5-low
  • openrouter/openai/gpt-5.5-medium
  • openrouter/openai/gpt-5.5-xhigh
  • openrouter/openai/gpt-5.6-luna
  • openrouter/openai/gpt-5.6-luna-high
  • openrouter/openai/gpt-5.6-luna-low
  • openrouter/openai/gpt-5.6-luna-medium
  • openrouter/openai/gpt-5.6-luna-xhigh
  • openrouter/openai/gpt-5.6-sol
  • openrouter/openai/gpt-5.6-sol-high
  • openrouter/openai/gpt-5.6-sol-low
  • openrouter/openai/gpt-5.6-sol-medium
  • openrouter/openai/gpt-5.6-sol-xhigh
  • openrouter/openai/gpt-5.6-terra
  • openrouter/openai/gpt-5.6-terra-high
  • openrouter/openai/gpt-5.6-terra-low
  • openrouter/openai/gpt-5.6-terra-medium
  • openrouter/openai/gpt-5.6-terra-xhigh
  • openrouter/openai/gpt-audio
  • openrouter/openai/gpt-audio-mini
  • openrouter/openai/gpt-chat-latest
  • openrouter/openai/gpt-oss-120b
  • openrouter/openai/gpt-oss-120b-high
  • openrouter/openai/gpt-oss-120b-low
  • openrouter/openai/gpt-oss-120b-medium
  • openrouter/openai/gpt-oss-20b
  • openrouter/openai/gpt-oss-20b-high
  • openrouter/openai/gpt-oss-20b-low
  • openrouter/openai/gpt-oss-20b-medium
  • openrouter/openai/gpt-oss-safeguard-20b
  • openrouter/openai/gpt-oss-safeguard-20b-high
  • openrouter/openai/gpt-oss-safeguard-20b-low
  • openrouter/openai/gpt-oss-safeguard-20b-medium
  • openrouter/openai/o1
  • openrouter/openai/o1-pro
  • openrouter/openai/o3
  • openrouter/openai/o3-mini
  • openrouter/openai/o3-mini-high
  • openrouter/openai/o3-pro
  • openrouter/openai/o4-mini
  • openrouter/openai/o4-mini-high
  • openrouter/perceptron/perceptron-mk1
  • openrouter/perplexity/sonar
  • openrouter/perplexity/sonar-deep-research
  • openrouter/perplexity/sonar-pro
  • openrouter/perplexity/sonar-pro-search
  • openrouter/perplexity/sonar-reasoning-pro
  • openrouter/poolside/laguna-s-2.1
  • openrouter/poolside/laguna-xs-2.1
  • openrouter/qwen/qwen-2.5-72b-instruct
  • openrouter/qwen/qwen-2.5-7b-instruct
  • openrouter/qwen/qwen-2.5-coder-32b-instruct
  • openrouter/qwen/qwen-plus
  • openrouter/qwen/qwen-plus-2025-07-28
  • openrouter/qwen/qwen-plus-2025-07-28:thinking
  • openrouter/qwen/qwen2.5-vl-72b-instruct
  • openrouter/qwen/qwen3-14b
  • openrouter/qwen/qwen3-235b-a22b
  • openrouter/qwen/qwen3-235b-a22b-2507
  • openrouter/qwen/qwen3-235b-a22b-thinking-2507
  • openrouter/qwen/qwen3-30b-a3b
  • openrouter/qwen/qwen3-30b-a3b-instruct-2507
  • openrouter/qwen/qwen3-30b-a3b-thinking-2507
  • openrouter/qwen/qwen3-32b
  • openrouter/qwen/qwen3-8b
  • openrouter/qwen/qwen3-coder
  • openrouter/qwen/qwen3-coder-30b-a3b-instruct
  • openrouter/qwen/qwen3-coder-flash
  • openrouter/qwen/qwen3-coder-next
  • openrouter/qwen/qwen3-coder-plus
  • openrouter/qwen/qwen3-max
  • openrouter/qwen/qwen3-max-thinking
  • openrouter/qwen/qwen3-next-80b-a3b-instruct
  • openrouter/qwen/qwen3-next-80b-a3b-thinking
  • openrouter/qwen/qwen3-vl-235b-a22b-instruct
  • openrouter/qwen/qwen3-vl-235b-a22b-thinking
  • openrouter/qwen/qwen3-vl-30b-a3b-instruct
  • openrouter/qwen/qwen3-vl-30b-a3b-thinking
  • openrouter/qwen/qwen3-vl-32b-instruct
  • openrouter/qwen/qwen3-vl-8b-instruct
  • openrouter/qwen/qwen3-vl-8b-thinking
  • openrouter/qwen/qwen3.5-122b-a10b
  • openrouter/qwen/qwen3.5-27b
  • openrouter/qwen/qwen3.5-35b-a3b
  • openrouter/qwen/qwen3.5-397b-a17b
  • openrouter/qwen/qwen3.5-9b
  • openrouter/qwen/qwen3.5-flash-02-23
  • openrouter/qwen/qwen3.5-plus-02-15
  • openrouter/qwen/qwen3.5-plus-20260420
  • openrouter/qwen/qwen3.6-27b
  • openrouter/qwen/qwen3.6-35b-a3b
  • openrouter/qwen/qwen3.6-flash
  • openrouter/qwen/qwen3.6-max-preview
  • openrouter/qwen/qwen3.6-plus
  • openrouter/qwen/qwen3.7-flash
  • openrouter/qwen/qwen3.7-max
  • openrouter/qwen/qwen3.7-plus
  • openrouter/qwen/qwen3.8-max
  • openrouter/rekaai/reka-edge
  • openrouter/rekaai/reka-flash-3
  • openrouter/relace/relace-apply-3
  • openrouter/relace/relace-search
  • openrouter/sakana/fugu-ultra
  • openrouter/sao10k/l3-lunaris-8b
  • openrouter/sao10k/l3.1-euryale-70b
  • openrouter/sao10k/l3.3-euryale-70b
  • openrouter/stepfun/step-3.5-flash
  • openrouter/stepfun/step-3.7-flash
  • openrouter/tencent/hunyuan-a13b-instruct
  • openrouter/tencent/hy3
  • openrouter/tencent/hy3-preview
  • openrouter/thedrummer/cydonia-24b-v4.1
  • openrouter/thedrummer/rocinante-12b
  • openrouter/thedrummer/skyfall-36b-v2
  • openrouter/thedrummer/unslopnemo-12b
  • openrouter/thinkingmachines/inkling
  • openrouter/thinkingmachines/inkling-small
  • openrouter/undi95/remm-slerp-l2-13b
  • openrouter/upstage/solar-pro-3
  • openrouter/writer/palmyra-x5
  • openrouter/x-ai/grok-4.20
  • openrouter/x-ai/grok-4.20-multi-agent
  • openrouter/x-ai/grok-4.3
  • openrouter/x-ai/grok-4.3-high
  • openrouter/x-ai/grok-4.3-low
  • openrouter/x-ai/grok-4.3-medium
  • openrouter/x-ai/grok-4.5
  • openrouter/x-ai/grok-4.5-high
  • openrouter/x-ai/grok-4.5-low
  • openrouter/x-ai/grok-4.5-medium
  • openrouter/x-ai/grok-build-0.1
  • openrouter/xiaomi/mimo-v2.5
  • openrouter/xiaomi/mimo-v2.5-pro
  • openrouter/z-ai/glm-4.5
  • openrouter/z-ai/glm-4.5-air
  • openrouter/z-ai/glm-4.5v
  • openrouter/z-ai/glm-4.6
  • openrouter/z-ai/glm-4.6v
  • openrouter/z-ai/glm-4.7
  • openrouter/z-ai/glm-4.7-flash
  • openrouter/z-ai/glm-5
  • openrouter/z-ai/glm-5-turbo
  • openrouter/z-ai/glm-5.1
  • openrouter/z-ai/glm-5.2
  • openrouter/z-ai/glm-5.2-high
  • openrouter/z-ai/glm-5.2-max
  • openrouter/z-ai/glm-5v-turbo
  • openrouter/~anthropic/claude-fable-latest
  • openrouter/~anthropic/claude-haiku-latest
  • openrouter/~anthropic/claude-opus-latest
  • openrouter/~anthropic/claude-sonnet-latest
  • openrouter/~deepseek/deepseek-v4-flash-latest
  • openrouter/~google/gemini-flash-latest
  • openrouter/~google/gemini-pro-latest
  • openrouter/~moonshotai/kimi-latest
  • openrouter/~openai/gpt-latest
  • openrouter/~openai/gpt-latest-high
  • openrouter/~openai/gpt-latest-low
  • openrouter/~openai/gpt-latest-medium
  • openrouter/~openai/gpt-latest-xhigh
  • openrouter/~openai/gpt-mini-latest
  • openrouter/~x-ai/grok-latest
Claude Code CLI (cc/*) (13)
  • cc/claude-fable-5
  • cc/claude-haiku-4-5-20251001
  • cc/claude-opus-4-5-20251101
  • cc/claude-opus-4-6
  • cc/claude-opus-4-7
  • cc/claude-opus-4-8
  • cc/claude-opus-5
  • cc/claude-sonnet-4-5-20250929
  • cc/claude-sonnet-4-6
  • cc/claude-sonnet-5
  • cc/haiku
  • cc/opus
  • cc/sonnet
Codex CLI (codex/*) (9)
  • codex/codex-auto-review
  • codex/default
  • codex/gpt-5.2
  • codex/gpt-5.4
  • codex/gpt-5.4-mini
  • codex/gpt-5.5
  • codex/gpt-5.6-luna
  • codex/gpt-5.6-sol
  • codex/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}
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kiss_agent_framework-2026.8.12.tar.gz (20.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kiss_agent_framework-2026.8.12-py3-none-any.whl (7.4 MB view details)

Uploaded Python 3

File details

Details for the file kiss_agent_framework-2026.8.12.tar.gz.

File metadata

  • Download URL: kiss_agent_framework-2026.8.12.tar.gz
  • Upload date:
  • Size: 20.5 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

Hashes for kiss_agent_framework-2026.8.12.tar.gz
Algorithm Hash digest
SHA256 098cf2008aa85d5a6196c44c50119bd9efe5e4a4e68c3530e202b9dc50e1695b
MD5 3699300b210df85fc9f194d92322cb55
BLAKE2b-256 b3df324958058e2f365e048f5f21d9252095a07f9da99e24dc65f416907a8253

See more details on using hashes here.

File details

Details for the file kiss_agent_framework-2026.8.12-py3-none-any.whl.

File metadata

  • Download URL: kiss_agent_framework-2026.8.12-py3-none-any.whl
  • Upload date:
  • Size: 7.4 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

Hashes for kiss_agent_framework-2026.8.12-py3-none-any.whl
Algorithm Hash digest
SHA256 0cc398484933a6ed76aaf707cbbd5d0f6c9d997b3d6810e2b48a85585b440afb
MD5 8f87d5e186081648bf6de30bb49673b1
BLAKE2b-256 4361486fcd1526351788f1865bb57a2023dd89378affa2e4cd770ff90ca142df

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page