JetBot

# JetBot

**Browser-based AI Coding Assistant — Zero Install. Zero Deploy. Zero Config.**

[中文文档](README.zh-CN.md)

JetBot is a fully browser-based AI coding assistant. No backend server, no deployment pipeline, no installation required — just open the page and start working. All code executes client-side via JavaScript; LLM calls go directly from the browser's `fetch()` to your chosen API provider.

```
┌─────────────────────────────────────────────┐
│                  Browser                     │
│                                              │
│  ┌──────────┐  ┌───────────┐  ┌───────────┐ │
│  │  React   │  │  Agentic  │  │  Virtual   │ │
│  │   UI     │←→│   Loop    │←→│   FS       │ │
│  └──────────┘  └─────┬─────┘  │ (IndexedDB)│ │
│                      │        └───────────┘ │
│                      │ fetch()               │
└──────────────────────┼──────────────────────┘
                       ↓
              ┌────────────────┐
              │  LLM Provider  │
              │ OpenAI/DeepSeek│
              │ Ollama/Custom  │
              └────────────────┘
```

## Quick Start

```bash
git clone https://github.com/hongxin/JetBot.git
cd JetBot/jetbot
npm install
npm run dev
```

Open `http://localhost:5173`, select an LLM provider, enter your API key, and start chatting.

**Local Ollama (fully offline):**

```bash
ollama serve
ollama pull qwen3.5:27b
# Select the Ollama provider in JetBot — no API key needed
```

**Production build:**

```bash
npm run build
# Outputs dist/ — pure static files deployable to any static host
```

## Features

### Agentic Loop

An autonomous tool-calling loop where the LLM selects tools, executes actions, and analyzes results until the task is complete. Supports up to 100 iterations with circuit breaker protection (3 consecutive failures) and automatic duplicate-error detection.

### 10 Built-in Tools

| Tool | Permission | Description |
|------|-----------|-------------|
| `read_file` | safe | Read files from the virtual file