Skip to content

Installation

This guide covers the complete installation process for the FCC Agent Team Framework, including prerequisites, optional dependencies, and verification steps.

Prerequisites

  • Python 3.10 or later. FCC uses modern Python features including union type syntax (str | None) and dataclasses with frozen=True. Python 3.10, 3.11, 3.12, and 3.13 are all supported.
  • pip and venv. Both are included with standard Python installations. If you are using a system-managed Python, you may need to install the python3-venv package.
  • Git. Required to clone the repository.
  • make (optional). The project includes a Makefile for common tasks. All commands can also be run directly.

Install from PyPI

The quickest way to get started:

pip install fcc-agent-team-ext

This installs the fcc package with all core dependencies (pyyaml, jsonschema, click, jinja2, anthropic, openai, python-dotenv).

Verify the installation:

fcc --version

Install for Development (Editable)

For contributors who want to modify the source code:

git clone https://github.com/rollingthunderfourtytwo-afk/l2_fcc_agent_team_ext.git
cd l2_fcc_agent_team_ext
python -m venv .venv
source .venv/bin/activate   # On Windows: .venv\Scripts\activate
pip install -e ".[dev]"

Or using Make:

make venv && source .venv/bin/activate
make install-dev

Install from Source

Build and install directly from the repository:

git clone https://github.com/rollingthunderfourtytwo-afk/l2_fcc_agent_team_ext.git
cd l2_fcc_agent_team_ext
pip install .

Optional Dependencies

FCC offers several optional dependency groups for different use cases.

Documentation Tools

To build the MkDocs documentation site locally:

pip install fcc-agent-team-ext[docs]

Or in development mode:

pip install -e ".[docs]"

This adds mkdocs, mkdocs-material, mkdocs-material-extensions, and pymdown-extensions.

Observability

To enable OpenTelemetry-based observability with native OTel span export:

pip install fcc-agent-team-ext[observability]

Or in development mode:

pip install -e ".[observability]"

This adds opentelemetry-api and opentelemetry-sdk. Without this extra, FCC falls back to its built-in tracing implementation, which provides the same span model without the OTel integration.

All Optional Dependencies

Install everything at once:

pip install fcc-agent-team-ext[docs,observability]

Or in development mode with all extras:

pip install -e ".[dev,docs,observability]"

Dependency Group Summary

Group Command What It Adds
Core pip install fcc-agent-team-ext pyyaml, jsonschema, click, jinja2, anthropic, openai, python-dotenv
Docs pip install fcc-agent-team-ext[docs] mkdocs, mkdocs-material, pymdown-extensions
Observability pip install fcc-agent-team-ext[observability] opentelemetry-api, opentelemetry-sdk
Dev pip install -e ".[dev]" pytest, pytest-cov, ruff

AI Provider Configuration

FCC supports Anthropic and OpenAI as AI providers for live simulations. To use them, set the appropriate environment variables:

# For Anthropic Claude
export ANTHROPIC_API_KEY="your-key-here"

# For OpenAI
export OPENAI_API_KEY="your-key-here"

You can also use a .env file in the project root. FCC uses python-dotenv to load environment variables automatically.

Mock mode (the default) requires no API keys and is recommended for development and testing.

Verification

After installation, verify everything is working:

# Check the CLI is available
fcc --help

# Run the test suite
make test

# Or directly with pytest
pytest

# Check code quality
make lint

A successful test run should report 1,971+ passing tests with 99%+ code coverage.

Next Steps