██╗   ██╗ ██████╗ ██╗██████╗     ███╗   ███╗ █████╗ ████████╗██████╗ ██╗██╗  ██╗
██║   ██║██╔═══██╗██║██╔══██╗    ████╗ ████║██╔══██╗╚══██╔══╝██╔══██╗██║╚██╗██╔╝
██║   ██║██║   ██║██║██║  ██║    ██╔████╔██║███████║   ██║   ██████╔╝██║ ╚███╔╝
╚██╗ ██╔╝██║   ██║██║██║  ██║    ██║╚██╔╝██║██╔══██║   ██║   ██╔══██╗██║ ██╔██╗
 ╚████╔╝ ╚██████╔╝██║██████╔╝    ██║ ╚═╝ ██║██║  ██║   ██║   ██║  ██║██║██╔╝ ██╗
  ╚═══╝   ╚═════╝ ╚═╝╚═════╝     ╚═╝     ╚═╝╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝╚═╝  ╚═╝

☿ MULTI-TOOL AI AGENT ☿

[ AGENTIC WORKFLOWS // TOOL ORCHESTRATION // COMMAND R+ ]

Autonomous tool orchestration powered by Cohere Command R+.

    ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
    ░░      ▄▄▄▄      ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░      ░░
    ░░    ▄█████▄     ░░     AN AUTONOMOUS AGENT THAT USES TOOLS           ░░░░
    ░░   ▄███████▄    ░░     TO ACCOMPLISH ANY TASK AUTONOMOUSLY          ░░░░
    ░░  ▀▀███████▀▀   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
    ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

---

◬ SYSTEM MANIFEST

╔═══════════════════════════════════════════════════════════════════════════════╗
║                                                                               ║
║   ██████████████████████████████████████████████████████████████████████████  ║
║   ██                                                                      ██  ║
║   ██   A powerful AI agent framework built on Cohere's Command R+         ██  ║
║   ██   Featuring multi-tool orchestration for real-world task execution   ██  ║
║   ██   Web search • Code execution • Math • Scraping • Time/Date         ██  ║
║   ██                                                                      ██  ║
║   ██████████████████████████████████████████████████████████████████████████  ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝

---

◬ TOOL ARSENAL

☿ INFORMATION ┏━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ◈ WEB SEARCH ┃ ┃ DuckDuckGo API ┃ ┃ Real-time results ┃ ┣━━━━━━━━━━━━━━━━━━━━━━━━┫ ┃ ◈ WEB SCRAPER ┃ ┃ Extract content ┃ ┃ Parse any URL ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━┛

☿ COMPUTATION ┏━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ◈ CALCULATOR ┃ ┃ Safe math eval ┃ ┃ Complex formulas ┃ ┣━━━━━━━━━━━━━━━━━━━━━━━━┫ ┃ ◈ PYTHON EXECUTOR ┃ ┃ Sandboxed runtime ┃ ┃ Code generation ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━┛

☿ UTILITIES ┏━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ ◈ TIME/DATE ┃ ┃ Any timezone ┃ ┃ Calculations ┃ ┣━━━━━━━━━━━━━━━━━━━━━━━━┫ ┃ ◈ TOOL CHAINING ┃ ┃ Multi-step tasks ┃ ┃ Auto-orchestration ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━┛

---

◬ FEATURE MATRIX

CAPABILITY	DESCRIPTION	STATUS
WEB_SEARCH	Real-time internet search via DuckDuckGo	◈ ONLINE
CALCULATOR	Safe mathematical expression evaluation	◈ ONLINE
PYTHON_EXEC	Sandboxed Python code execution	◈ ONLINE
WEB_SCRAPE	Content extraction from any webpage	◈ ONLINE
TIMEZONE	Current time in any global timezone	◈ ONLINE
MULTI_TURN	Contextual conversation memory	◈ ONLINE
TOOL_CHAIN	Automatic multi-tool orchestration	◈ ONLINE

---

◬ SYSTEM ARCHITECTURE

                    ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
                    ┃              USER INTERFACE LAYER                 ┃
                    ┃         [ CLI // WEB UI // API CLIENT ]           ┃
                    ┗━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
                                          ┃
                                          ▼
                    ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
                    ┃               FASTAPI SERVER                      ┃
                    ┃              [ Async // REST ]                    ┃
                    ┗━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
                                          ┃
                                          ▼
    ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
    ┃                           ☿ COHERE AGENT CORE ☿                           ┃
    ┃                                                                           ┃
    ┃   ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓    ┃
    ┃   ┃  ◈ Conversation Management     ◈ Tool Selection                 ┃    ┃
    ┃   ┃  ◈ Context Retention           ◈ Response Synthesis             ┃    ┃
    ┃   ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛    ┃
    ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
                                      ┃
                                      ▼
                    ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
                    ┃           COHERE API [ COMMAND R+ ]               ┃
                    ┃          [ Tool Use // Chat // Reasoning ]        ┃
                    ┗━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
                                          ┃
                                          ▼
    ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
    ┃                            ☿ TOOL LAYER ☿                                 ┃
    ┃                                                                           ┃
    ┃   ┏━━━━━━━━━━━┓  ┏━━━━━━━━━━━┓  ┏━━━━━━━━━━━┓  ┏━━━━━━━━━━━┓             ┃
    ┃   ┃ Web Search┃  ┃Calculator ┃  ┃  Python   ┃  ┃  Scraper  ┃             ┃
    ┃   ┗━━━━━━━━━━━┛  ┗━━━━━━━━━━━┛  ┗━━━━━━━━━━━┛  ┗━━━━━━━━━━━┛             ┃
    ┃                                                                           ┃
    ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

---

◬ EXECUTION EXAMPLES

CLI Interface

╭──────────────────────────────────────────────────────────────────────────────╮
│                                                                              │
│  ▸ You: What's the latest news about quantum computing?                      │
│                                                                              │
│  ◈ Agent thinking...                                                         │
│    ┗━ Executing: web_search({"query": "quantum computing news 2024"})        │
│    ┗━ Result received                                                        │
│                                                                              │
│  ◈ Agent: Based on my search, here are the latest developments...            │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  ▸ You: Calculate compound interest on $10000 at 7% for 5 years              │
│                                                                              │
│  ◈ Agent thinking...                                                         │
│    ┗━ Executing: calculator({"expression": "10000 * (1 + 0.07) ** 5"})       │
│    ┗━ Result received                                                        │
│                                                                              │
│  ◈ Agent: The compound interest calculation shows $14,025.52                 │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  ▸ You: Write Python code to find prime numbers up to 100                    │
│                                                                              │
│  ◈ Agent thinking...                                                         │
│    ┗━ Executing: execute_python({"code": "..."})                             │
│    ┗━ Result received                                                        │
│                                                                              │
│  ◈ Agent: Here are the prime numbers: [2, 3, 5, 7, 11, 13, ...]              │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯

---

◬ QUICK START

PREREQUISITES

╔════════════════════════════════════════════════════════════╗
║  ◈ Python 3.10+                                            ║
║  ◈ Cohere API Key → https://dashboard.cohere.com/api-keys  ║
╚════════════════════════════════════════════════════════════╝

INSTALLATION

# Clone the repository
git clone https://github.com/BabyChrist666/cohere-multi-tool-agent.git
cd cohere-multi-tool-agent

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env → Add your COHERE_API_KEY

EXECUTE

# Run CLI Agent
python agent.py

# Launch Web Server
python server.py
# Access: http://localhost:8000

---

◬ API ENDPOINTS

POST /chat — Agent Interaction

curl -X POST http://localhost:8000/chat \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Search for Cohere AI news",
    "session_id": "user123"
  }'

GET /tools — List Available Tools

curl http://localhost:8000/tools

GET /health — System Status

curl http://localhost:8000/health

---

◬ EXTEND THE ARSENAL

Adding Custom Tools

# tools.py

# 1. Define tool schema
TOOL_DEFINITIONS.append({
    "type": "function",
    "function": {
        "name": "my_tool",
        "description": "What my tool does",
        "parameters": {
            "type": "object",
            "properties": {
                "param1": {"type": "string", "description": "..."}
            },
            "required": ["param1"]
        }
    }
})

# 2. Implement the function
def my_tool(param1: str) -> dict:
    # Your logic here
    return {"success": True, "result": "..."}

# 3. Register executor
TOOL_EXECUTORS["my_tool"] = my_tool

---

◬ DIRECTORY STRUCTURE

cohere-multi-tool-agent/
├── agent.py           # Core agent logic
├── tools.py           # Tool definitions & executors
├── server.py          # FastAPI server & endpoints
├── requirements.txt   # Dependencies
└── README.md          # Documentation

---

◬ DEPLOYMENT

Docker

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["python", "server.py"]

Cloud Platforms

◈ Railway    → Set COHERE_API_KEY → Deploy
◈ Render     → Set COHERE_API_KEY → Deploy
◈ Fly.io     → Set COHERE_API_KEY → Deploy

---

◬ DOCUMENTATION

◈ Swagger UI    →  http://localhost:8000/docs
◈ ReDoc         →  http://localhost:8000/redoc

---

◬ TECH STACK

Cohere Command R+

FastAPI Async Server

DuckDuckGo Search API

Python Runtime

---

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                        ☿ BUILT FOR THE COHERE ECOSYSTEM ☿
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

MIT License

Tools are the extensions of will. Execute without hesitation.