Nine1Bot

# Nine1Bot

[简体中文](./README.zh.md)

A versatile personal AI assistant featuring a web interface and tunnel support for remote access.

Supports programming, file management, information retrieval, content creation, and more through natural language interaction.

> **Security Warning**
>
> Nine1Bot can execute system commands and read/write files. Security is not fully guaranteed yet:
>
> - Avoid running complex tasks on devices with important data
> - Don't let AI access sensitive files or credentials
> - Consider using in a virtual machine or test environment
> - Back up important data regularly

## Features

### Core Capabilities

- **Programming** - Code writing, debugging, refactoring, code review, supporting multiple languages and frameworks
- **File Management** - Read, create, edit, organize files, batch rename, directory structure management
- **File Preview** - Preview images, code, Markdown, HTML, Office documents in Web UI
- **File Upload** - Upload files directly through the web interface for AI processing
- **Command Execution** - Run system commands, script writing, environment configuration, automation
- **Information Retrieval** - Web search, data analysis, content extraction and summarization
- **Content Creation** - Document writing, report generation, email drafting, translation, copywriting
- **Office Tasks** - Meeting notes, scheduling, spreadsheet processing, format conversion
- **Task Management** - Todo tracking, work breakdown, progress management, reminders
- **Q&A** - Technical consulting, solution suggestions, troubleshooting, tutoring

### Product Features

- **Web Interface** - Modern chat interface with Markdown rendering, code highlighting, agent console monitoring
- **Multi-Model Support** - Anthropic Claude, OpenAI, Google Gemini, OpenRouter, and more
- **Session Working Directory** - Each session can have its own working directory with built-in directory browsing
- **User Preferences** - Record personal preferences, AI follows your habits across all sessions
- **Terminal History** - Scrollback history support for terminal output
- **Tunnel Support** - Built-in ngrok and NATAPP support for public access
- **Password Protection** - Optional web access password protection
- **Parallel Sessions** - Run up to 10 AI sessions simultaneously
- **Hot Reload** - Skills and MCP config changes take effect automatically without restart
- **Ready to Use** - Download and run, includes Bun runtime

### Built-in Skills

Nine1Bot includes several built-in skills, invoked via `/skill-name`:

| Skill            | Description                                              |
| ---------------- | -------------------------------------------------------- |
| `/remember`      | Record user preferences, AI follows them in all sessions |
| `/pdf`           | PDF processing: extract text, merge/split, form filling  |
| `/docx`          | Word document creation, editing, revision tracking       |
| `/pptx`          | PowerPoint presentation creation and editing             |
| `/mcp-builder`   | Development guide for creating MCP servers               |
| `/skill-creator` | Development guide for creating custom Skills             |

You can also add custom Skills in `~/.config/nine1bot/skills/`.

### Configuration Compatibility

Nine1Bot supports integrating configurations from:

| Config Type        | OpenCode | Claude Code | Notes                                                              |
| ------------------ | -------- | ----------- | ------------------------------------------------------------------ |
| MCP Servers        | ✅       | ✅          | Can inherit MCP config from OpenCode and Claude Code               |
| Skills             | ✅       | ✅          | Can inherit custom skills from OpenCode and Claude Code            |
| Provider Auth      | ✅       | ❌          | Can inherit API Keys and OAuth from OpenCode                       |
| Official Providers | ❌       | -           | OpenCode official providers not supported (requires authorization) |

Control inheritance through config:

```jsonc
{
  "isolation": {
    "inheritOpencode": true, // Inherit OpenCode config
    "inheritClaudeCode": true, // Inherit Claude Code config
  },
}
```

## Installation

### Option 1: Download Release (Recommended)

Download from [Releases](https://github.com/contrueCT/nine1bot/releases):

| Platform | Architecture  | Filename                              |
| -------- | ------------- | ------------------------------------- |
| Linux    | x64           | `nine1bot-linux-x64-vX.X.X.tar.gz`    |
| Linux    | ARM64         | `nine1bot-linux-arm64-vX.X.X.tar.gz`  |
| macOS    | Apple Silicon | `nine1bot-darwin-arm64-vX.X.X.tar.gz` |
| Windows  | x64           | `nine1bot-windows-x64-vX.X.X.zip`     |

**Linux / macOS:**

```bash
# Download and extract (Linux x64 example)
curl -fsSL https://github.com/contrueCT/nine1bot/releases/latest/download/nine1bot-linux-x64.tar.gz | tar -xz
cd nine1bot-linux-x64

# Run
./n

... (truncated)