OpenRouter Agent System

The OpenRouter Agent System is a general-purpose AI Agent platform composed of three independent services: a Vue 3 frontend, a FastAPI backend, and a sandboxed Docker environment for secure tool execution.

Features

• Modular Architecture: Three independent services for frontend, backend, and sandbox.
• Domain-Driven Design: The backend follows DDD principles for a clean and maintainable codebase.
• Secure Execution: The sandbox environment provides a secure way to execute shell commands, file operations, and browser automation.
• Real-time Communication: Server-Sent Events (SSE) are used for real-time communication between the backend and frontend.
• Extensible Tooling: The system supports a variety of tools, including browser automation, shell access, and file operations.
• VNC Visualization: Remotely view the sandbox environment through a VNC connection.

Project Structure

The project is a monorepo with the following structure:

• frontend/: A Vue 3 + TypeScript + Vite application for the user interface.
• backend/: A FastAPI service for session management, tool orchestration, and API routing.
• sandbox/: An isolated Docker environment for secure tool execution.

Getting Started

Prerequisites

• Docker
• pnpm

Installation

1. Clone the repository:

   git clone https://github.com/codienters/Operator.git
   cd Operator

2. Install dependencies for each sub-project:

   pnpm install
   cd frontend && pnpm install && cd ..
   cd backend && pnpm install && cd ..
   cd sandbox && pnpm install && cd ..

3. Start all services using Docker Compose:

   docker compose up -d

Usage

After starting the services, you can access the web interface at http://localhost:5173.

API Documentation

The backend service provides a FastAPI interface for session management and agent interaction. The API documentation is available at http://localhost:8000/docs when the backend service is running.

Credits

• Likhon Sheikh - https://t.me/likhonsheikh