PHASES 0 & 1 SHIPPED

Supratim

Open-source, model-agnostic agentic coding agent.
Built on the Pi toolkit • Showcasing Sarvam AI by default.

Get Started View on GitHub
dattaprasad-r-ekavade/supratim v0.1.0 Node ≥ 20.6 TypeScript MIT License Cross-platform

What is Supratim?

A terminal-first coding agent that helps you read, write, edit, and run commands in your project — powered by Sarvam AI models out of the box.

Built on the excellent open-source Pi toolkit. We focus on what matters: seamless Sarvam integration, secure key onboarding, usage tracking in ₹, and production-ready workflows.

🎯

Dogfood-First

Daily use in real repos is the only benchmark. Every phase ships something you’ll actually use.

🔌

Model-Agnostic

Sarvam showcased by default. Swap to any provider or local model via Pi’s architecture.

🧩

Depend, Don’t Fork

We build on top of Pi packages and stay aligned with upstream updates.

Architecture

Layers map cleanly onto Pi’s package structure with a thin custom layer on top.

CLI Surface supratim CLI + pi-tui
Core Engine pi-agent-core
Provider Layer Sarvam via pi-ai (OpenAI compatible)
Extensions sarvam-compat • usage-hud • secure-keytar

Build Roadmap

Phase 0 — Spike & Foundation

Shipped

Pi + Sarvam spike, friction log, depend-vs-fork

Phase 1 — CLI + Provider + Usage

Shipped

Secure key onboarding, INR usage HUD, MIT CLI

Phase 2 — MCP & Agentic Depth

In progress

MCP client layer, hooks, project-folder polish

Phase 3 — Compaction + CLI v1

Planned

Context compaction, feature parity, OSS launch

Phase 4–6 — GUI & v1.0

Planned

Tauri GUI, dual modes, packaging, docs site

What's Ready Today

🔑

Secure Key Onboarding

Beautiful TUI wizard. Keys stored safely in OS credential manager via keytar.

📊

Live Usage HUD

Real-time tokens, cost in ₹, context usage, and model info.

🛠️

Powerful Tools

read, write, edit, bash — all scoped to your project directory.

Sarvam Optimized

Full compatibility layer for content blocks and model limits.

Get Started

# Clone from GitHub
git clone https://github.com/dattaprasad-r-ekavade/supratim.git
cd supratim
npm install
npm run build

$ npm run dev

# Verify API key · one-shot task
$ npm run verify-key
$ node dist/cli.js -p "Summarize this repo"

Need a Sarvam API key? Get it here →

Project Structure

Supratim/
├── src/
│   ├── cli.ts
│   ├── onboarding.ts
│   ├── secure-storage.ts
│   └── extensions/
├── config/models.json
├── docs/phase0-friction-log.md
└── index.html