Installation

Prerequisites

• Python 3.13+ (will be automatically installed by uv)
• uv (easily manage Python environments and agents' dependencies)
• mcpd (interface to manage and run MCP servers)
• (Optional) Docker (for containerized server deployment)

Installation

1. Clone the repository and navigate to the agent's source directory:

   git clone https://github.com/mozilla-ai/agent-factory.git && cd agent-factory
   

2. Install the dependencies using uv:

   uv sync --dev
   

3. Activate the virtual environment:

   source .venv/bin/activate
   

4. Create a .env file in the project root directory and add your OpenAI API key and Tavily API key (required). You can get a free Tavily API key by signing up here.

   OPENAI_API_KEY=sk-...
   TAVILY_API_KEY=tvly_...
   

5. (Only required if you are developing the library) Install pre-commit hooks:

   pre-commit install