KISS Framework

"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 vs Claude Code vs Cursor
What is in the Name
Installation
Using KISS Sorcar
Messaging & Third-Party Agents
Models Supported
Contributing
License
Citation

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	643 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. A fourth interface, the sorcar terminal command, runs a SorcarAgent directly in the current directory without the daemon: sorcar -t "Summarize README.md" runs an inline task, sorcar -f task.txt runs the file's content as the task (exactly one of -t/-f is required; see sorcar --help for the model and budget flags).

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, scope_work_dir (workspace directory the task's tab is scoped to, when different from the execution work_dir), chat_id, use_worktree, auto_commit, max_budget, model_config (custom endpoint/headers), web_tools, is_parallel, timeout, stop_on_timeout (also stop the task when timeout expires; default False — the task keeps running), 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 computes the run's parameters and tools on the daemon; see Extension agents below.

Extension agents

An extension agent is a plain Python file whose path you pass as extension_agent_path to sorcar.run(). The daemon imports the file on every run and calls its top-level get_X() functions to compute the run's parameters; parameters without a getter keep whatever the caller passed. One file can define the task prompt, system prompt, model, budget, tools, and safety hooks — a complete custom agent:

# weather_agent.py — a minimal extension agent
import requests

def get_prompt() -> str:
    return "Look up the current weather in San Francisco and report it."

def get_max_budget() -> float:
    return 0.50

def get_use_worktree() -> bool:
    return False  # no repo changes expected

def get_if_append_basic_tools() -> bool:
    return False  # restrict the agent to finish + our tools

def get_system_prompt() -> str:
    return ("You are a weather assistant. Use the get_weather tool "
            "to look up weather, then call finish with the result.")

def get_weather(city: str) -> str:
    """Return current weather for a city from wttr.in.

    Args:
        city: City name to look up.
    """
    resp = requests.get(f"https://wttr.in/{city}?format=3", timeout=10)
    resp.raise_for_status()
    return resp.text.strip()

def get_tools() -> list:
    """Return the tools the agent may call."""
    return [get_weather]

from kiss.server import sorcar

result = sorcar.run(
    "placeholder",  # required non-blank; overridden by get_prompt()
    extension_agent_path="weather_agent.py",
)

Key points:

Overridable parameters. Every sorcar.run() parameter except timeout, stop_on_timeout, sock_path, scope_work_dir, web_tools, is_parallel, and extension_agent_path itself has a getter: get_prompt(), get_work_dir(), get_model(), get_chat_id(), get_system_prompt(), get_tools(), get_use_worktree(), get_auto_commit(), get_max_budget(), get_model_config(), get_if_append_basic_tools() (overrides append_basic_tools), get_append_to_system_prompt(), and get_append_to_prompt(). web_tools and is_parallel always keep the values passed to run() (their defaults when the caller passed none).
Atomic, type-checked overrides. Getters run in the daemon process and are re-imported from source on every run. Each return value is type-checked; overrides apply only after every getter succeeds, and a broken getter fails the task with a diagnostic in TaskResult.text.
Tools, two ways. get_tools() may return a list of callables — making the script its own tools file — or the path of a separate Python file whose get_tools() returns the callables. Either way the tools execute in the daemon process; nothing is serialized over the socket. get_tools() overrides (does not append to) the caller's tools argument.
Hook getters. get_llm_call_hook() and get_tool_call_hook() return functions with no run() equivalent (callables can't travel the wire). llm_call_hook(new_messages) runs before every LLM call and its return value replaces the outgoing messages; tool_call_hook(name, args) runs before every tool call — returning "OK" lets the tool execute, any other string suppresses the call and is given to the model as the tool's result:

# guarded_agent.py — veto dangerous shell commands
def tool_call_hook(name, args):
    if name == "Bash" and "rm -rf" in str(args.get("command", "")):
        return "Blocked: destructive command"
    return "OK"

def get_tool_call_hook():
    return tool_call_hook

The full authoring guide — every getter's semantics, error handling, chat continuation, model configuration, and a complete worked example — is 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 643 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	110
Anthropic	14
Gemini / Google	27
Together AI	91
Z.AI	8
Moonshot AI	10
OpenRouter	360
Claude Code CLI (`cc/*`)	14
Codex CLI (`codex/*`)	9

Current catalog capability totals:

623 generation-capable models
464 function-calling-capable models
11 embedding models

Full model list:

OpenAI (110)

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 (14)

claude-fable-5
claude-fable-5-1
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 (27)

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.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.5-transcribe
gemini-3.5-transcribe-live
gemini-3.6-flash
gemini-3.7-flash
gemini-3.8-flash
gemini-embedding-001
gemini-embedding-2
gemini-embedding-2-preview
gemini-omni-1.1-flash
gemini-omni-flash-preview
google/gemma-2-27b-it
google/gemma-3n-E4B-it
google/gemma-4-31B-it

Together AI (91)

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
Qwen/Qwen3.8-2.4T-A95B
Qwen/Qwen3.8-Flash
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-V4-Pro-0813
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
zai-org/GLM-5.3
zai-org/GLM-5.3-Flash

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 (360)

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/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-fable-5.1
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.8
openrouter/anthropic/claude-opus-5
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/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-1-turbo
openrouter/bytedance-seed/seed-2.0-code
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/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-flash-vision-exp
openrouter/deepseek/deepseek-v4-pro
openrouter/deepseek/deepseek-v4-pro-0813
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/gemini-3.7-flash
openrouter/google/gemini-3.8-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-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/ibm-granite/granite-4.2-8b
openrouter/inception/mercury-2
openrouter/inception/mercury-2.5-preview
openrouter/inclusionai/ling-3.0-flash
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-glimmer-30b
openrouter/meta/muse-spark-1.1
openrouter/meta/muse-spark-1.2
openrouter/meta/muse-spark-1.3
openrouter/microsoft/phi-4
openrouter/microsoft/wizardlm-2-8x22b
openrouter/mistralai/codestral-2508
openrouter/mistralai/devstral-2512
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/nvidia/nemotron-3.5-lightning
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.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-2.4t-a95b
openrouter/qwen/qwen3.8-27b
openrouter/qwen/qwen3.8-flash
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/hy-mt2-1.8b
openrouter/tencent/hy-mt2-30b-a3b
openrouter/tencent/hy-mt2-7b
openrouter/tencent/hy3
openrouter/tencent/hy3-preview
openrouter/tencent/hy4-preview
openrouter/thedrummer/cydonia-24b-v4.1
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/upstage/solar-pro4
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-4.6
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-5.3
openrouter/z-ai/glm-5.3-flash
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
openrouter/~z-ai/glm-flash-latest
openrouter/~z-ai/glm-latest

Claude Code CLI (cc/*) (14)

cc/claude-fable-5
cc/claude-fable-5-1
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.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.9.6.tar.gz (22.2 MB view details)

Uploaded Sep 5, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

kiss_agent_framework-2026.9.6-py3-none-any.whl (8.3 MB view details)

Uploaded Sep 5, 2026 Python 3

File details

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

File metadata

Download URL: kiss_agent_framework-2026.9.6.tar.gz
Upload date: Sep 5, 2026
Size: 22.2 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.9.6.tar.gz
Algorithm	Hash digest
SHA256	`278bf4e9d9710faadd54cb1f1f1529b5d6576748c8c3299d5b794ecd9c47c3a7`
MD5	`d96d7fa2ea19d81a2dd3538a77c23ca5`
BLAKE2b-256	`8ffedbe0a23432d4bd16f4bf4a7635649b14131bc66c0ac91e65adad81664dd5`

See more details on using hashes here.

File details

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

File metadata

Download URL: kiss_agent_framework-2026.9.6-py3-none-any.whl
Upload date: Sep 5, 2026
Size: 8.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

Hashes for kiss_agent_framework-2026.9.6-py3-none-any.whl
Algorithm	Hash digest
SHA256	`2ff5db74325031f6396235c024d1a672385422c80a43e47761aa143205d8f5cb`
MD5	`85b8d3a0714da9746a8d6fb7675eaa78`
BLAKE2b-256	`bdb079c5cd80cd7acbff249fd14b679c708a5ba2c5e9db6d36065ac8ccf792ee`