Installation¶

Learn how to install ReAct Agent Framework in your project.

Requirements¶

Python 3.8+
pip or uv package manager

Install from PyPI¶

Basic InstallationWith MCP SupportWith All ProvidersWith Memory BackendsEverything

pip install react-agent-framework

pip install react-agent-framework[mcp]

pip install react-agent-framework[anthropic,google]

pip install react-agent-framework[chroma,faiss]

pip install react-agent-framework[all]

Install from Source¶

For development or to get the latest changes:

# Clone the repository
git clone https://github.com/marcosf63/react-agent-framework.git
cd react-agent-framework

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

# Install in editable mode
pip install -e .

# Or with all extras
pip install -e ".[all]"

Optional Dependencies¶

AI Providers¶

# Anthropic Claude
pip install react-agent-framework[anthropic]

# Google Gemini
pip install react-agent-framework[google]

# All providers
pip install react-agent-framework[anthropic,google]

Memory Backends¶

# ChromaDB
pip install react-agent-framework[chroma]

# FAISS
pip install react-agent-framework[faiss]

# Both
pip install react-agent-framework[chroma,faiss]

MCP Support¶

# Model Context Protocol
pip install react-agent-framework[mcp]

Development Tools¶

# Development dependencies
pip install react-agent-framework[dev]

Verify Installation¶

from react_agent_framework import ReactAgent

# Check version
import react_agent_framework
print(react_agent_framework.__version__)  # Should print: 0.9.0

# Create a basic agent to test
agent = ReactAgent(name="Test Agent")
print(agent)  # Should print agent info

Configuration¶

API Keys¶

Create a .env file in your project root:

# OpenAI (default provider)
OPENAI_API_KEY=sk-...

# Anthropic (optional)
ANTHROPIC_API_KEY=sk-ant-...

# Google (optional)
GOOGLE_API_KEY=AI...

# Other services (optional)
GITHUB_TOKEN=ghp_...
BRAVE_API_KEY=...

Environment Variables¶

The framework automatically loads environment variables from .env files using python-dotenv.

Next Steps¶

Quickstart Guide - Get started in 5 minutes
Your First Agent - Build your first agent
Features Overview - Explore all features

Troubleshooting¶

ImportError: No module named 'react_agent_framework'¶

Make sure you've installed the package:

pip install react-agent-framework

Provider not found¶

Install the specific provider:

pip install react-agent-framework[anthropic]  # For Claude
pip install react-agent-framework[google]     # For Gemini

MCP tools not working¶

Install MCP support:

pip install react-agent-framework[mcp]

Using Virtual Environments

Always use virtual environments to isolate dependencies:

python -m venv .venv
source .venv/bin/activate