This guide will walk you through the steps required to install AgentForge on your system.
-
Python Version: AgentForge requires Python 3.11.
-
Check Python Version:
python3 --version
If Python is not installed or the version is anything other than 3.11, download version 3.11 from the official Python website.
Using a virtual environment helps avoid conflicts with system-wide packages.
-
Create a Virtual Environment:
python3 -m venv venv
-
Activate the Virtual Environment:
-
On Unix/macOS:
source venv/bin/activate
-
On Windows:
venv\Scripts\activate
-
With the virtual environment activated, install AgentForge using pip:
pip install agentforge
Depending on the language model service you plan to use with AgentForge, you may need to set up environment variables with your API keys. If you're using local models like LM Studio or Ollama, you do not need to set up environment variables for API keys.
export OPENAI_API_KEY='your-openai-api-key'
export ANTHROPIC_API_KEY='your-anthropic-api-key'
export GOOGLE_API_KEY='your-google-api-key'
Navigate to your project directory and initialize your AgentForge project:
python -m agentforge.init_agentforge
This command creates a new .agentforge
folder in your project with sub-folders containing YAML files:
your_project/
.agentforge/
actions/
personas/
prompts/
settings/
tools/
Now that your project is set up, you can proceed to the Using AgentForge Guide to learn how to run agents and build your solutions. This guide provides examples and instructions on how to create and interact with agents using AgentForge.
-
Review the Prerequisites Guide if you haven't set up API keys or other necessary configurations.
-
If you're having trouble with AgentForge, please head over to the Troubleshooting Guide for solutions to common issues.