Everything should be made as simple as possible, but not simpler.

— Albert Einstein

Open Source · Apache 2.0

An AI assistant that keeps it simple.

A general-purpose AI assistant and IDE built on the KISS Agent Framework—a stupidly-simple agentic core in roughly 1,850 lines of Python. It codes well, and it codes fast.

Both KISS Sorcar and the KISS Agent Framework are grounded in time-tested, robust software engineering principles so the code it produces is simple, elegant, maintainable, and bug-free.

Get Started Read the Paper GitHub

§ 01 — Install

Get started in one line.¶

All you need is an API key from a major LLM provider.

Command Line

$ curl -fsSL https://raw.githubusercontent.com/ksenxx/kiss_ai/main/scripts/install.sh | bash

VS Code Extension

Open VS Code, search KISS Sorcar in the Extension Marketplace, and install—or grab the .vsix directly.

From the Terminal

# Run a one-shot task

sorcar -t "What is 2435*234"

# Start a new chat session (-n) and stay in chat mode

sorcar -n -t --use-chat "What is 2435*234?"

# Use a specific model

sorcar -m "claude-sonnet-4-6" -t "What is 2435*234?"

# Read the task from a file

echo "Can you find the cheapest non-stop flight from SFO to JFK on June 15 by consulting various websites?" > prompt

sorcar -f prompt

# Drive a desktop app

sorcar -t 'Can you send the message "Hello from Sorcar!" to ksen via the desktop slack app?'

# Explain a code path step by step

sorcar -t 'Can you show me the detailed step-by-step workflow of gepa.py?'

§ 02 — Features

Everything you need, nothing you don't.¶

Built for software engineering and general-purpose automation.

General-Purpose Assistant

More than a coding tool. Books flights, drives desktop apps, navigates websites, explains code, and automates everyday workflows from a single prompt.

Time-Tested Engineering Principles

Both KISS Sorcar and the KISS Agent Framework are built on robust, time-tested software engineering principles so the code it produces is simple, elegant, maintainable, and bug-free.

Third-Party Agents

OpenClaw-style integrations let the agent live inside the apps you already use — Slack, Discord, Teams, WhatsApp, iMessage, Telegram, Signal, Gmail, cron, and more. Authentication is handled for you.

Runs Relentlessly

Automatic summarization and continuation across sub-sessions. Never gives up until the task is done.

Browser Automation

Built-in Chromium via Playwright. Navigate, click, fill forms, take screenshots — all programmatically.

Git Worktree Isolation

Every task runs on its own branch in a separate worktree. Your working tree stays untouched.

Docker Support

Execute tasks inside Docker containers for sandboxed, reproducible environments.

Multimodal Input

Understands images, screenshots, and text. Attach visual context to your prompts.

Budget Tracking

Tokens, cost, and time at every step. Hard budget ceilings prevent runaway spending.

Cross-Session Learning

Learns your preferences and project invariants via USER_PREFS.md. Gets better over time.

CLI + VS Code

Rich VS Code extension or command-line tool. Same agent, your choice of interface.

Quality Over Speed

Runs linters, type checkers, and tests before declaring success. Clean, well-tested code.

§ 03 — Architecture

Five layers. One concern each.¶

A clean hierarchy of agents — each adding exactly one capability — totalling about 1,850 lines of Python.

KISS Agent

Budget-tracked ReAct loop with native function calling.

409 LOC

Relentless Agent

Automatic summarization and continuation across sub-sessions.

297 LOC

Sorcar Agent

Coding tools, browser automation, and parallel sub-agent execution.

323 LOC

Chat Sorcar Agent

Persistent multi-turn chat sessions with history recall.

120 LOC

Worktree Sorcar Agent

Git worktree isolation — every task lives on its own branch.

692 LOC

§ 04 — Models

Bring your own model.¶

Works with the providers you already use.

Anthropic

Claude Opus 4.7, Opus 4.6, Sonnet 4.6, Sonnet 4, Haiku 4.5 and more

OpenAI

GPT-5.5, GPT-5.4, o4-mini, o3-pro, Codex series and more

Google Gemini

Gemini 3.1 Pro, 3 Flash, 2.5 Pro, 2.5 Flash and more

Together AI

Llama 4, Qwen 3.5, DeepSeek V4, Kimi K2.6, GLM-5.1 and more

OpenRouter

330+ models from 50+ providers via a unified API

Embeddings

OpenAI, Google, Together AI embedding models for RAG and search

§ 05 — Third-Party Agents

Reach the agent from anywhere.¶

OpenClaw-style integrations let KISS Sorcar live inside the apps you already use — chat from Slack, schedule from cron, drive an Android phone, or send a message from Signal. Authentication is handled for you; you confirm before anything is sent.

Team Chat

Slack, Discord, Microsoft Teams, Google Chat, Mattermost, Matrix, IRC, Nextcloud Talk, Synology Chat

Personal Messaging

WhatsApp, iMessage, Telegram, Signal, SMS, BlueBubbles

Regional

Feishu, LINE, Zalo

Email & Streaming

Gmail and Twitch — read mail, post chat, react to events from a single agent loop

Decentralized

Tlon (Urbit) and Nostr for self-sovereign communication

Phone & Scheduling

Android phone control over a companion REST app, plus a cron-manager daemon for scheduled, recurring agent runs

§ 07 — Citation

Cite the paper.¶

If you use KISS Sorcar in your research, please cite:

Koushik Sen. KISS Sorcar: A Stupidly-Simple General-Purpose and Software Engineering AI Assistant. arXiv preprint arXiv:2604.23822, 2026.

@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}
}