agb-moltbot-starter

A powerful and user-friendly AGB (AGent Bot) starter project with React frontend and Python Flask backend. This project provides a streamlined interface for managing AGB sessions, including session creation, file browsing, code execution, and remote desktop viewing.

Quick Start

Prerequisites

• Node.js 20+
• Python 3.11+
• Get AGB API Key

Installation

# Install dependencies, uv will take care of the python interpreter and venv creation, and install the required packages
uv sync

install web UI dependencies via pnpm:

cd ./web
pnpm install

Running the Application

# Run both the backend and frontend servers in development mode
./bootstrap.sh -d

The application will be available at http://localhost:5173

To modify the port, edit the PORT environment variable in server/config.py or use the --port option with the start scripts.

The production artifacts will be in the dist/ directory.

Usage Guide

1. Connect: Enter your AGB API Key and click "Connect"
2. Automatic Session Creation: The system automatically creates a moltbot-linux-ubuntu-2204 session
3. Maximized View: The session stream automatically opens in maximized view
4. Manage Sessions: Use the session list to switch between sessions or create new ones
5. Browse Files: Navigate the file system of your sessions
6. Run Code: Execute code snippets in Python, JavaScript, or Shell

Project Structure

agb-moltbot-starter/
├── server/
│   ├── main.py           # Flask backend server
├── web/
│   ├── src/
│   │   ├── main.jsx        # React entry point
│   │   └── Debugger.jsx    # Main debugger component
│   ├── public/             # Static assets
│   └── package.json        # Frontend dependencies

API Endpoints

• POST /api/connect - Verify API Key and connect to AGB
• POST /api/sessions - List sessions
• POST /api/sessions/create - Create a new session
• POST /api/sessions/link - Get session stream link
• POST /api/sessions/delete - Release/delete a session
• POST /api/files/list - List files in a session directory
• POST /api/files/download - Download a file from a session
• POST /api/code/run - Execute code in a session

License

See LICENSE file for details.