Nine1Bot

简体中文

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

The convenience of Claude / ChatGPT web apps, with the power of Claude Desktop.

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

Zero dependencies - download, extract, and run. No runtime or package manager required.

Screenshots

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
• Browser Control - Built-in browser automation via Chrome / Edge extension
• Password Protection - Optional web access password protection (username: nine1bot)
• 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

Browser Control

Nine1Bot has built-in browser automation with two modes: control the user's own browser via an extension (Chrome / Edge and other Chromium-based browsers), or launch a dedicated AI-controlled browser process. The AI can navigate pages, fill forms, take screenshots, click elements, and more.

Setup:

1. Open your browser's extension management page:
   • Chrome: chrome://extensions/
   • Edge: edge://extensions/
2. Enable Developer mode (top-right toggle)
3. Click Load unpacked and select the browser-extension folder from your Nine1Bot installation
4. Enable browser control in your config:

{
  "browser": {
    "enabled": true
  }
}

Note: The extension uses sensitive permissions (debugger, scripting, all_urls) for full browser automation. Only use in trusted environments.

Webhooks

The Webhooks page lets external services trigger project-bound agent runs through JSON requests. Each source has a system-generated URL and secret; the full URL is shown only when the source is created or the secret is refreshed.

Built-in presets provide quick starts for Generic JSON, Uptime Kuma incidents, and GitLab merge request review events. Presets only prefill mappings, prompts, sample payloads, and guards, so every source remains fully editable.

curl -X POST "http://127.0.0.1:4096/webhooks/{sourceId}/{secret}" \
  -H "Content-Type: application/json" \
  -d '{"event":"deploy_failed","severity":"warning","message":"Health check failed"}'

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/.

Tip: You can install MCP servers and custom Skills simply by telling the AI in chat. Just describe what you need or paste a relevant URL, and the AI will handle the installation automatically.

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

Control inheritance through config:

{
  "isolation": {
    "inheritOpencode": true // Inherit OpenCode global/project config
  },
  "skills": {
    "inheritOpencode": true, // Inherit OpenCode skills
    "inheritClaudeCode": true // Inherit Claude Code skills
  },
  "mcp": {
    "inheritOpencode": true, // Inherit OpenCode MCP servers
    "inheritClaudeCode": true // Inherit Claude Code MCP servers
  },
  "provider": {
    "inheritOpencode": true // Inherit OpenCode provider auth
  }
}

Custom LLM Providers (OpenAI / Anthropic Protocol)

You can add providers in the Settings page (Auth Manager -> Custom Providers) or edit nine1bot.config.jsonc directly:

{
  "customProviders": {
    "my-openai": {
      "name": "My OpenAI",
      "protocol": "openai",
      "baseURL": "https://example.com/v1",
      "models": [{ "id": "gpt-4o-mini", "name": "GPT-4o mini" }]
    },
    "my-anthropic": {
      "name": "My Anthropic",
      "protocol": "anthropic",
      "baseURL": "https://anthropic-proxy.example.com",
      "models": [{ "id": "claude-3-5-sonnet-latest" }]
    }
  }
}

Notes:

• customProviders defines provider structure only (protocol, endpoint, models)
• API keys are still stored locally via the auth page in auth.json
• Supported protocol values are currently openai and anthropic

Installation

Option 1: Download Release (Recommended)

Download from 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

macOS (Homebrew recommended):

brew install contrueCT/nine1bot/nine1bot

Update with brew upgrade nine1bot, uninstall with brew uninstall nine1bot.

Linux:

# 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
./nine1bot

Windows:

1. Download nine1bot-windows-x64-vX.X.X.zip
2. Extract to any directory
3. Double-click nine1bot.bat or run from command line

Option 2: One-Line Install Script (Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/contrueCT/nine1bot/main/install.sh | bash

After installation, run nine1bot from any directory.

Option 3: Install from Source

Requires Bun.

# Clone repository
git clone https://github.com/contrueCT/nine1bot.git
cd nine1bot

# Install dependencies
cd opencode && bun install && cd ..
cd packages/nine1bot && bun install && cd ../..
cd web && bun install && cd ..

# Build web frontend
cd web && bun run build && cd ..

# Run
bun run nine1bot

Usage

First Run

On first run, you'll be prompted to run the setup wizard:

Welcome to Nine1Bot! Would you like to run the setup wizard?

The wizard guides you through:

• Server port (default 4096)
• Password protection (optional)
• Tunnel configuration (optional, for public access)
• AI Provider API Key

You can skip and run nine1bot setup later.

Command Line

# Start server (default command)
nine1bot

# Specify port
nine1bot --port 8080
nine1bot -p 8080

# Enable tunnel
nine1bot --tunnel
nine1bot -t

# Don't open browser automatically
nine1bot --no-browser

# Run setup wizard
nine1bot setup

# View config
nine1bot config show

# Set config value
nine1bot config set server.port 8080

# Edit config file
nine1bot config edit

# Show help
nine1bot --help

Web Interface

After starting, open http://127.0.0.1:4096 (or your configured port) in browser.

Features:

• Create multiple sessions with independent working directories
• Browse and select working directories per session
• Upload files for AI processing
• Switch AI models
• View and manage files
• Watch AI thinking process in real-time
• Abort running tasks

User Preferences

Nine1Bot can remember your personal preferences. AI will automatically follow these preferences in all sessions.

Setting Preferences

Option 1: Web Interface

Click the "Preferences" tab in settings panel to add, edit, or delete preferences.

Option 2: Use /remember command in chat

Tell AI your preferences directly in conversation:

/remember Reply in English
/remember Use 4-space indentation for code
/remember Don't use emoji

Preference Examples

• Reply in English - AI will respond in English
• Use 4-space indentation for code - Generated code uses 4-space indentation
• Give detailed code explanations - AI provides more detailed code explanations
• Write commit messages in English - Git commit messages will be in English

Preferences are automatically injected into every conversation prompt.

Configuration

Config file locations:

• Project config: nine1bot.config.jsonc (installation directory)
• Global config: ~/.config/nine1bot/config.jsonc (Linux/macOS) or %APPDATA%\nine1bot\config.jsonc (Windows)

Config Example

{
  // Server config
  "server": {
    "port": 4096,
    "hostname": "127.0.0.1",
    "openBrowser": true,
  },

  // Password protection (username is fixed as "nine1bot")
  "auth": {
    "enabled": true,
    "password": "your-password",
  },

  // Tunnel config
  "tunnel": {
    "enabled": true,
    "provider": "ngrok", // or "natapp"
    "ngrok": {
      "authToken": "your-ngrok-token",
    },
  },

  // AI Provider config
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "sk-ant-xxxxx",
      },
    },
  },

  // Default model
  "model": "anthropic/claude-sonnet-4-20250514",
}

Environment Variables

Config files support environment variable substitution:

{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}",
      },
    },
  },
}

Tunnel Configuration

Tunnel Security Warning

Enabling tunnel exposes your Nine1Bot instance to the internet. Please note:

• Strongly recommended to enable password protection: Without a password, anyone can access and control your AI assistant
• Tunnel URLs are logged: Services like ngrok/NATAPP record access logs
• Don't share tunnel URLs: Unless you trust the recipient
• Close unused tunnels promptly: Prolonged public exposure increases attack risk
• Avoid processing sensitive data in tunnel mode: Public transmission may be intercepted

ngrok (International)

1. Register at ngrok
2. Get authtoken
3. Configure:

{
  "tunnel": {
    "enabled": true,
    "provider": "ngrok",
    "ngrok": {
      "authToken": "your-ngrok-token",
    },
  },
}

NATAPP (China)

1. Register at NATAPP
2. Create tunnel, get authtoken
3. Download NATAPP client and add to PATH
4. Configure:

{
  "tunnel": {
    "enabled": true,
    "provider": "natapp",
    "natapp": {
      "authToken": "your-natapp-token",
    },
  },
}

Update

Release Installation

# Run update script
./scripts/update.sh

Source Installation

cd ~/.nine1bot  # or your installation directory
git pull
cd opencode && bun install && cd ..
cd packages/nine1bot && bun install && cd ../..
cd web && bun install && bun run build && cd ..

FAQ

Port in use

Use --port to specify another port:

nine1bot --port 8080

Command not found

If nine1bot command not found after script installation:

source ~/.bashrc  # or source ~/.zshrc

Or restart your terminal.

Run in background

nohup nine1bot --no-browser > nine1bot.log 2>&1 &

Or use systemd service (see INSTALL.md).

Development

# Start development mode
bun run dev

# Start web dev server
bun run web

# Build web frontend
bun run build:web

Contributing

Welcome to contribute to Nine1Bot!

• Submit Issues for bugs or suggestions
• Submit Pull Requests to contribute code
• Share usage experiences and best practices
• Help improve documentation and translations

Please read CONTRIBUTING.md for development setup, issue guidelines, and PR expectations.

Acknowledgments

Thanks to the OpenCode community. Nine1Bot is built on OpenCode.

License

MIT