README.md

metadata

title: 🦅 Multeclaw
emoji: 🦅
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 6.13.0
app_file: app.py
pinned: true
license: mit
short_description: Multi-model AI agent with GPT, Claude, Llama, Groq
tags:
  - agent
  - multi-model
  - chat
  - tools
  - openai
  - anthropic
  - llama
  - mistral

🦅 Multeclaw — Multi-Model AI Agent System

A complete AI agent framework connecting GPT, Claude, Llama, Mistral, Qwen, Groq, and Ollama through a single unified interface with built-in tool execution, multi-step planning, and safety layers.

🏗️ Architecture

Component	Role
Router	Classifies tasks → direct, tool-assisted, multi-step, code, analysis
Planner	Decomposes complex objectives into executable step sequences
LLM Client	Unified streaming interface across 5 providers
Executor	Runs LLM completions and tool calls
Memory	Tracks conversation history, tool results, and session context
Tool System	Sandboxed calculator, code execution, file I/O
Safety Layer	Input content filtering
Repair Loop	Retries failed tool calls with error context

🤖 Supported Providers & Models

Provider	Models	Key Feature
OpenAI	GPT-4o, GPT-4o Mini, GPT-4 Turbo	Strong reasoning, tool calling
Anthropic	Claude 4 Opus, Claude 4 Sonnet, Claude 3.5 Haiku	Deep analysis, 200K context
HuggingFace	Llama 3 8B, Qwen 2.5 72B, Mistral 7B	Open models via inference API
Groq	Llama 3 70B, Mixtral 8x7B	Ultra-fast inference
Ollama	Any local model	Privacy, offline use

🔄 Agent Loops

1. Reasoning Loop — LLM processes the request with full conversation context
2. Tool Loop — LLM decides to call tools, results are fed back iteratively
3. Planning Loop — Complex tasks auto-decomposed into steps, executed sequentially
4. Repair Loop — Failed operations retried with error context

🛠️ Built-in Tools

• Calculator — Safe math evaluation with Python math syntax
• Code Executor — Sandboxed Python execution with timeout
• File Reader/Writer — Safe file I/O operations
• Web Search — (Placeholder for integration)

🚀 Quick Start

1. Go to the 🔑 Settings tab
2. Enter your API key(s) for the provider(s) you want to use
3. Go to the 💬 Chat tab
4. Select a model from the dropdown
5. Start chatting!

🎭 Personas

• Multeclaw Agent — General-purpose AI agent
• Code Expert — Senior software engineer
• Research Analyst — Thorough research analysis
• Creative Writer — Vivid, engaging writing
• Data Scientist — Rigorous data analysis
• Custom — Your own system prompt

📁 Project Structure

multeclaw/
├── __init__.py          # Package exports
├── config.py            # Model registry, prompts, tools, agent config
├── llm_client.py        # Unified multi-provider LLM client
├── agent.py             # Agent core: router, planner, executor, memory, safety
└── ui.py                # Gradio UI with 6 tabs
app.py                   # Entry point
requirements.txt         # Dependencies

🛡️ Safety

• Input content filtering blocks harmful requests
• Code execution sandboxed with 30s timeout
• API keys stored in-memory only, never persisted
• File operations restricted to safe paths
• Math evaluation uses allowlisted functions only