Koraku

Embeddable ReAct agent SDK — your personal AI buddy, open source.

Koraku is a Python SDK for building agents with tools (web, files, shell, Composio integrations) and an optional self-hosted HTTP server. Use it in-process, behind FastAPI, or from web clients via @koraku/client.

• License: MIT
• Docs: docs/SDK.md
• Security: SECURITY.md

Quick start

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev,server,all]"

from koraku import Koraku, KorakuConfig

agent = Koraku(KorakuConfig(fireworks_api_key="...", llm_provider="fireworks"))
async for event in agent.stream("Summarize this repo"):
    print(event)

Self-hosted API

cp .env.example .env   # add LLM keys
uvicorn koraku.server_sdk:app --reload --port 8000

• GET /health — liveness
• POST /stream — chat SSE
• GET /api/composio/* — Connections proxy (when COMPOSIO_API_KEY is set)

Install options

Extra	Purpose
koraku	Core SDK
koraku[server]	FastAPI + uvicorn
koraku[composio]	Gmail, Slack, Drive, … via Composio
koraku[blaxel]	Remote Blaxel sandboxes (execution_target=sandbox)
koraku[all]	Common self-host bundle

Development

pip install -e ".[dev,all]"
pytest -q
./scripts/verify-sdk-wheel.sh