CBbot

KO | EN

gitlite — search

#javascript #php #dotfiles #c-plus-plus #java #python #abandoned #opencv #ruby #linux #chezmoi #cpp

★ 68 Open GitHub ↗

CBbot is a new product form within the CodeBanana ecosystem, positioned as a local-first intelligent agent with full-spectrum operational capabilities. CBbot turns fragmented tools, manual operations, and scattered workflows into a unified, executable AI system.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CBbot - AI Coding Assistant 🚀

> **✨ Zero Dependencies · One-Click Login · Fully Native ✨**

<div align="center">
  <p><strong>🍎🪟 Native Desktop App · One-Click Setup · Ready Out of the Box</strong></p>
</div>

---

## 💻 What is CBbot?

CBbot is an **AI-native agent OS** that specializes in coding and task automation with seamless integration both locally and in the cloud.

**Key Features:**
- ✅ **SOTA AI Coding Agent**: Built-in powerful AI coding capabilities supporting the best global models
- ✅ **Zero Dependencies**: No Docker, WSL, or any external tools required - completely native
- ✅ **One-Click Login**: Just click to open browser login - no manual key copying
- ✅ **Auto Configuration**: No manual configuration file editing required
- ✅ **Safe Execution Environment**: Secure runtime isolation protects your system from unauthorized access
- ✅ **Extensible Skill System**: Pre-loaded skills library with compatibility for open-source domain skills

## 💻 System Requirements

> **🎯 Zero Dependencies**: No Docker, WSL, or external tools needed - just download and run!

### macOS
- **Operating System**: macOS 10.15 (Catalina) or higher
- **Chip**: Apple Silicon only (M1/M2/M3/M4) - Tested on all M-series chips
- **Memory**: 8GB or more recommended
- **Disk Space**: At least 2GB available
- **Dependencies**: ✅ **None** - Fully native application
- **Internet**: Required for AI features

### Windows
- **Operating System**: Windows 10 (64-bit) or Windows 11 required
- **Architecture**: x64 (Intel/AMD 64-bit)
- **Memory**: 8GB or more recommended
- **Disk Space**: At least 2GB available
- **Dependencies**: ✅ **None** - Fully native application (no WSL)
- **Internet**: Required for AI features

## 📦 Download CBbot

<div align="center">
  <table>
    <tr>
      <td align="center">
        <strong>🍎 macOS (Apple Silicon)</strong><br>
        <a href="https://codebanana-1308581983.cos.na-siliconvalley.myqcloud.com/releases/cbbot/v3.7.4/CBbot-mac-arm64-v3.7.4.dmg">⬇️ Download CBbot.dmg</a><br>
        <small>M1/M2/M3/M4 chips - Tested on all M-series</small>
      </td>
      <td align="center">
        <strong>🪟 Windows</strong><br>
        <a href="https://codebanana-1308581983.cos.na-siliconvalley.myqcloud.com/releases/cbbot/v3.7.4/CBbot-lite-win-x64-v3.7.4.exe">⬇️ Download CBbot-Setup.exe</a><br>
        <small>Windows 10/11 (64-bit) - No WSL required</small>
      </td>
    </tr>
  </table>
</div>

## 📦 Installation

### macOS Installation

1. **Download**: Get the latest `.dmg` file from the [Releases page](https://github.com/mobvoi/CBbot/releases/latest)
2. **Install**: 
   - Double-click `CBbot.dmg`
   - Drag **CBbot** to **Applications** folder
3. **Launch & Login**: 
   - Open **Applications** → **CBbot**
   - First launch: Click "Open" when prompted by security dialog
   - Click **"Login"** button - your browser will open automatically
   - Complete login in browser - CBbot will auto-detect and start
   - Done! No keys to copy, no manual configuration needed

### Windows Installation

1. **Download**: Get the latest `.exe` file from the [Releases page](https://github.com/mobvoi/CBbot/releases/latest)
2. **Install**: 
   - Run `CBbot-Setup.exe`
   - Follow the installation wizard
   - Choose installation directory (default recommended)
3. **Launch & Login**:
   - Find **CBbot** in Start Menu
   - Click **"Login"** button - your browser will open automatically
   - Complete login in browser - CBbot will auto-detect and start
   - Done! No keys to copy, no manual configuration needed

> **💡 Easy Login**: CBbot uses browser-based login - just click the button and log in. The app automatically detects your login and starts. No need to copy any keys or tokens manually!

---

## 📑 Contents

- [🧠 Skills](#-skills)
- [🛠️ Troubleshooting](#️-troubleshooting)
- [💬 Community](#-community)
- [💰 Billing](#-billing)
- [📄 License](#-license)

## 🌐 Network Tips

**For Users in China:**

CBbot works without VPN, but using one improves performance. Since CBbot connects to overseas servers, a VPN provides faster and more stable connections.

**Optional VPN Setup:**
1. Enable VPN with global proxy mode
2. Restart CBbot after VPN is connected
3. Enjoy faster response times

> **💡 Note:** VPN is optional but recommended for better experience in mainland China.

---

## ⚙️ Advanced Configuration (Optional)

### Configure Feishu Bot

To enable Feishu bot functionality:

1. Open CBbot application
2. Go to **"Settings" → "Bot Configuration" → "Feishu"**
3. Enter your **App ID** and **App Secret**
4. Click **"Save"** and restart service

### Configure Telegram Bot

To enable Telegram bot functionality:

1. Open CBbot application
2. Go to **"Settings" → "Bot Configuration" → "Telegram"**
3. Enter your **Bot Token** and **Username**
4. Click **"Save"** and restart service

### Configure Discord Bot

To enable Discord bot functionality:

1. Open CBbot application
2. Go to **"Settings" → "Bot Configuration" → "Discord"**
3. Enter your **Bot Token**
4. Click **"Save"** and restart service

> **💡 Tip:** All configurations are done through CBbot's graphical interface - no manual configuration file editing required!

---

## 🧠 Skills

CBbot automatically uses the right skill for your task:

**Documents:** docx, pptx, xlsx, pdf  
**Automation:** macos-automation, custom skills

**Usage Example:**
- "Create presentation" → Uses pptx skill
- "Analyze Excel data" → Uses xlsx skill
- "Send email" → Uses macos-automation

No need to specify skills - CBbot picks the right one!

**Add Your Own:**
Contribute to `skills/` directory. See `codebanana-skill-guide` for details.

---

## 🛠️ Troubleshooting

### Common Issues

**CBbot won't start:**
- Ensure you have stable internet connection
- Check system meets minimum requirements (8GB RAM, 2GB disk space)
- Restart your computer and try again
- On Windows: Run as Administrator on first launch

**Can't access interface:**
- Wait 30-60 seconds for startup on first launch
- Check firewall isn't blocking CBbot
- Try restarting the application

**Key binding failed:**
- Verify your Key has no extra spaces
- Check network connection
- Get a new Key from [CodeBanana](https://www.codebanana.com)

### macOS Specific

**"Cannot open" security warning:**
- Go to **System Settings** → **Privacy & Security**
- Click **Open Anyway** next to CBbot warning
- Click **Open** in the confirmation dialog

**Permission denied errors:**
- Grant required permissions when prompted
- Check **System Settings** → **Privacy & Security** → **Files and Folders**

### Windows Specific

**"Windows protected your PC" warning:**
- Click **More info**
- Click **Run anyway**
- This is normal for new applications

**Firewall blocking:**
- Add CBbot to Windows Firewall exceptions
- Go to **Windows Security** → **Firewall & network protection** → **Allow an app**

**Installation fails:**
- Run installer as Administrator (right-click → "Run as administrator")
- Disable antivirus temporarily during install
- Install to default directory (avoid paths with spaces or special characters)

---

## 🔧 Uninstall

### macOS
Drag CBbot from Applications to Trash, then empty Trash.

### Windows
1. Open **Settings** → **Apps** → **Apps & features**
2. Search for **CBbot**
3. Click **CBbot** → **Uninstall**
4. Follow the uninstall wizard

Alternatively:
1. Open **Control Panel** → **Programs and Features**
2. Find **CBbot** in the list
3. Right-click → **Uninstall**

---

## 💬 Community

Join our community for support, discussions, and updates!

### 🌐 International Community

### 🇨🇳 中文社区

<div align="center">
  <table>
    <tr>
      <td align="center">
        <img src="https://oci-useast-backend-public.dupdub.com/subtitles/image/35f1e711-f7c1-4894-a1a4-e0ca133aa4cc.png" alt="飞书群" width="150">
        <br>
        <strong>🚀 飞书群</strong>
        <br>
        <small>CBbot交流群</small>
      </td>
      <td align="center">
        <img src="https://oci-useast-backend-public.dupdub.com/subtitles/image/df588231-d149-4a29-92bc-e4c6dbf5f51f.jpg" alt="微信群" width="150">
        <br>
        <strong>💬 微信群</strong>
        <br>
        <small>CBbot 交流群</small>
      </td>
    </tr>
  </table>
</div>

<div align="center">
  <p>🚀 <strong>Get help, share ideas, and connect with other developers!</strong></p>
  <p>💡 <strong>获得帮助、分享想法、与其他开发者交流！</strong></p>
</div>

---

## 💰 Billing

- **Pay-as-you-go** based on usage
- Linked via CBbot Key
- Costs: API calls + model usage

Monitor usage at [CodeBanana](https://www.codebanana.com) dashboard

---

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

<div align="center">
  <p><strong>Happy Coding! 🎉</strong></p>
  <p>Made with ❤️ by the <a href="https://www.codebanana.com">CodeBanana</a> team</p>
</div>

CBbot

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README