https://github.com/nwokike/kiri-code
An autonomous, serverless, 100% browser-based AI coding IDE. Built with WebContainers, Pyodide, and isomorphic-git. Bring your own LLM key and let the agent build, run, and push code directly to your GitHub without a backend.
https://github.com/nwokike/kiri-code
ai ai-agents isomorphic-git pyodide vibe-coding wasm web-containers webcontainer
Last synced: about 1 month ago
JSON representation
An autonomous, serverless, 100% browser-based AI coding IDE. Built with WebContainers, Pyodide, and isomorphic-git. Bring your own LLM key and let the agent build, run, and push code directly to your GitHub without a backend.
- Host: GitHub
- URL: https://github.com/nwokike/kiri-code
- Owner: Nwokike
- License: mit
- Created: 2026-04-13T10:58:48.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-13T13:08:10.000Z (about 2 months ago)
- Last Synced: 2026-04-13T13:11:32.855Z (about 2 months ago)
- Topics: ai, ai-agents, isomorphic-git, pyodide, vibe-coding, wasm, web-containers, webcontainer
- Language: TypeScript
- Homepage:
- Size: 385 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://opensource.org/licenses/MIT)
An autonomous, 100% serverless, polyglot AI coding IDE that runs entirely in your browser.
Kiri Code brings the power of cloud-native development to the Edge. Built on top of WebContainers, it provides a full Node.js operating system inside your browser, augmented by background WebWorkers for Python, PHP, and Ruby execution. No backend. No Docker. No monthly server costs.
---
## 🌟 Features
* **Zero-Backend Architecture:** Everything from file hosting to AI agent orchestration happens locally on the client.
* **The "Two-Brain" Polyglot Engine:** Seamlessly write and execute Node.js, Python (Pyodide), PHP, and Ruby natively in the browser without UI-blocking.
* **Bring Your Own Key (BYOK) Vault:** Supports 20+ LLM providers (Anthropic, Gemini, OpenAI, Deepseek, etc.) via encrypted local storage.
* **Serverless GitHub Autonomy:** Uses `isomorphic-git` and LightningFS to clone, commit, and push directly to GitHub, bypassing traditional backends.
* **Progressive Web App (PWA):** Installable on iOS, Android, and Desktop. Caches heavy WASM binaries locally for instant offline boots.
* **Professional UX:** Utilizes `flexlayout-react` for a fully customizable, draggable, VS Code-like pane system.
---
## 🏗️ The Architecture Explained
Kiri Code solves several notoriously difficult browser-IDE challenges:
### 1. The File System Bridge
WebContainers (Node.js) and WASM environments (like Pyodide) operate in isolated memory spaces. Kiri Code utilizes a custom `RuntimeRouter` that recursively syncs LightningFS (IndexedDB) with the active WebWorker memory just-in-time for execution, allowing Python scripts to read files created by the Node.js agent.
### 2. The Agent-Terminal Emitter
Instead of hiding AI agent thoughts in the developer console, Kiri Code utilizes a `terminalEmitter` bus to pipe the Vercel AI SDK's tool executions (like running `npm install` or writing files) directly into the user's `xterm.js` UI, providing a transparent "Vibe Coding" experience.
### 3. Continuous Auto-Sync
A dedicated background loop watches the WebContainer memory. Upon any file change, it debounces for 1 second, writes the file to the browser's persistent IndexedDB, and queues a background Git commit.
---
## 🚀 Getting Started
Because Kiri Code requires highly specific Cross-Origin Isolation headers for WebContainers, you must run it using the provided Vite dev server.
### Prerequisites
* Node.js 18+
* `pnpm` (recommended) or `npm`
### Installation
```bash
# 1. Clone the repository
git clone https://github.com/Nwokike/kiri-code.git
cd kiri-code
# 2. Install dependencies
npm install
# 3. Start the dev server
npm run dev
```
### Production Deployment
Kiri Code is built to be deployed on Edge networks like Cloudflare Pages or Vercel. Ensure your hosting provider is configured to send the following HTTP headers:
```http
Cross-Origin-Embedder-Policy: require-corp
Cross-Origin-Opener-Policy: same-origin
```
---
## 🔑 Security & BYOK
Kiri Code operates strictly on a **Bring Your Own Key** model.
1. Click the **"ON"** profile badge in the top right.
2. Enter your GitHub PAT or LLM Provider API keys.
3. Keys are saved to `localStorage`. They are never transmitted anywhere except directly to the official LLM/GitHub endpoints.
---
## 📜 License
This project is licensed under the [MIT License](LICENSE).