Skip to content

armgit / camel

Public Imported from GitHub
0

๐Ÿซ CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org

3.9 KB
Raw Blame

CAMEL-AI with ACI Integration Examples

This repository contains two different approaches to integrate ACI.dev (AI Compute Infrastructure) with CAMEL-AI agents:

  1. Direct ACI Toolkit Integration (aci_toolkit_camel.py)
  2. MCP Server Integration (camel_mcp_aci.py)

๐Ÿš€ Features

  • Two Integration Approaches: Choose between direct ACI toolkit usage or MCP server integration
  • Multiple AI Services: Access to BRAVE_SEARCH, GITHUB, and ARXIV through ACI
  • Gemini Model Integration: Uses Google's Gemini 2.5 Pro model for AI responses
  • Error Handling: Comprehensive error handling with detailed traceback information

๐Ÿ“ Project Structure

.
โ”œโ”€โ”€ aci_toolkit_camel.py    # Direct ACI Toolkit integration
โ”œโ”€โ”€ camel_mcp_aci.py        # MCP server integration approach
โ”œโ”€โ”€ create_config.py        # MCP configuration generator
โ”œโ”€โ”€ README.md               # This file
โ””โ”€โ”€ env.example            # Environment variables template

๐Ÿ› ๏ธ Setup

Prerequisites

  • Python 3.10+
  • ACI.dev API access
  • Google Gemini API access

Installation

  1. Clone the repository:

    git clone https://github.com/camel-ai/camel
    cd camel/examples/usecases/aci_mcp/
    
  2. Install dependencies:

    uv pip install camel-ai[all]==0.2.61 rich aci-mcp
    
  3. Set up environment variables:

    cp env.example .env
    # Edit .env with your API keys and configuration
    

๐Ÿ”ง Configuration

Environment Variables

Create a .env file with the following variables:

  • ACI_API_KEY: Your ACI API key
  • GEMINI_API_KEY: Your Google Gemini API key
  • LINKED_ACCOUNT_OWNER_ID: Your linked account owner ID (e.g., GitHub username)

You can get these from:

๐ŸŽฏ Usage

Approach 1: Direct ACI Toolkit Integration

This approach uses the ACI toolkit directly within the CAMEL-AI framework:

python aci_toolkit_camel.py

Features:

  • Direct integration with ACI toolkit
  • Simpler setup and configuration
  • Immediate access to ACI.dev tools
  • Rich console output with progress indicators

Approach 2: MCP Server Integration

This approach uses MCP (Model Context Protocol) servers to provide ACI.dev functionality:

python camel_mcp_aci.py

Features:

  • Uses MCP protocol for tool integration
  • More modular and extensible architecture
  • Interactive user input for queries
  • Automatic configuration generation
  • Support for multiple MCP servers

๐Ÿ”ง Troubleshooting

Common Issues

  1. Missing API Keys: Ensure all required environment variables are set in your .env file
  2. ACI.dev MCP Installation: Make sure aci-mcp is properly installed for MCP approach
  3. Network Issues: Check internet connectivity for API calls
  4. Permission Issues: Ensure proper permissions for file creation (config.json)

Debug Mode

Both scripts include comprehensive error handling with traceback information for debugging.

Links