A baseline starter repo from the Agent Foundry team. Teams fork this repo into their own environment and customize it for their use case. Shared infrastructure (DI, lifecycle, middleware, retry, OTel, tool loading) lives in the published foundry-agent-* packages — this repo is the composition root that wires them into a runnable service.
The four foundry-agent-* wheels this repo depends on are published as
assets on boozallen/foundry-agent-packages
GitHub Releases. The default pyproject.toml pins each package to its
GitHub Release wheel URL so a fresh clone runs out of the box — useful for
evaluation, demos, and POCs.
Intended adoption pattern: mirror the wheels into your own internal
package index (Artifactory, AWS CodeArtifact, Sonatype Nexus, GitLab
Package Registry, etc.) and repoint the dependency specs in pyproject.toml
at that index. Direct dependence on github.com release URLs is fine for
kicking the tires, but production deployments should resolve packages from
infrastructure you control.
just setup # Install dependencies and pre-commit hooks
just check # Run all quality checks (lint, format, type-check, test)
just test # Run tests with coverage
just lint # Ruff lint + format check
just type-check # basedpyrightRequires Python 3.14+ and uv installed.
| If you want to… | Read |
|---|---|
Get the agent running locally with Python and uv |
Quickstart (Local Python) |
| Get the agent running in a container | Quickstart (Docker Compose) |
| Understand the codebase (file layout, packages, extension points) | AGENTS.md |
| Configure the model, system prompt, MCP servers, A2A peers | Configuration guide |
| Add tools, API endpoints, guardrails, or customize the server | Guides — start with After You Fork |
| Understand the security posture and STIG checklist | security/README.md |
| Contribute changes | CONTRIBUTING.md |