USF Agents — Simplify the Complex, Amplify the Intelligent for Enterprise
Orchestrate multiple agents with ease: register agents, integrate tools, define custom instructions, and leverage multiple models.
Enterprise-grade and production-ready, with full control, deep customization, strong defaults, clear boundaries, and developer-focused APIs.
USF Agents
This is the official documentation for the USF Agents Python SDK.
📖 Docs: Quickstart | Installation | Configuration | Troubleshooting / FAQ
Installation & Requirements
Requirements
- Python 3.9+
- USF API key (set as an environment variable)
Install the SDK
pip install usf-agents
Other package managers:
# uv
uv add usf-agents
# poetry
poetry add usf-agents
# pdm
pdm add usf-agents
Set Your API Key
# macOS/Linux
export USF_API_KEY=YOUR_KEY
# Windows PowerShell
$env:USF_API_KEY="YOUR_KEY"
# Windows CMD
set USF_API_KEY=YOUR_KEY
(Optional) Virtual Environment
python -m venv .venv
# macOS/Linux
source .venv/bin/activate
# Windows PowerShell
.venv\Scripts\Activate.ps1
Verify Installation
pip show usf-agents
Minimal import check:
python - <<'PY'
try:
import usf_agents
print("usf_agents import: OK")
except Exception as e:
print("Import failed:", e)
PY
Quick Sanity Run
Requires your USF_API_KEY to be set.
# sanity.py
import os
import asyncio
import nest_asyncio
from usf_agents import ManagerAgent
nest_asyncio.apply()
async def main():
mgr = ManagerAgent(
usf_config={
"api_key": os.getenv("USF_API_KEY"),
"model": "usf-mini"
}
)
result = await mgr.run("Say 'hello world'", {"mode": "auto"})
if result.get("status") == "final":
print("Final:", result.get("content"))
else:
print("Pending tool calls:", result.get("tool_calls"))
if __name__ == "__main__":
asyncio.run(main())
Run it:
python sanity.py
Documentation
Getting Started
Tools
Multi-Agent
- Overview
- Execution Modes
- Context Modes
- Manager-driven Delegation
- Skip Planning (No Tools)
- Custom Instruction
Jupyter Notebook Guides
- Email Drafting Assistant
- Customer Support Triage
- Planner-Worker Delegation
- Strict JSON Output
- Currency Converter
FastAPI Apps
- Email Drafting Assistant
- Customer Support Triage
- Planner-Worker Delegation
- Strict JSON Output
- Currency Converter
License
See LICENSE.
Metadata
Release files for usf-agents 1.0.0.post10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| usf_agents-1.0.0.post10.tar.gz | 58.2 kB | Without provenance | Details for usf_agents-1.0.0.post10.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| usf_agents-1.0.0.post10-py3-none-any.whl | Python 3 | none | any | Details for usf_agents-1.0.0.post10-py3-none-any.whl |
Total release size: 111.3 kB
Release files / usf_agents-1.0.0.post10.tar.gz
| Download URL | usf_agents-1.0.0.post10.tar.gz |
|---|---|
| Size | 58.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
37b707f97d3a64194e53564b38ab260439d51834856fb48059421bdf3b84095c
|
|
BLAKE2b-256 checksum How to use checksums |
6641e7a1c75adeccdbce8c4bc590a3e8cc04f294ce6e92c5eb56e72e3cb9e494
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.11
|
Release files / usf_agents-1.0.0.post10-py3-none-any.whl
| Download URL | usf_agents-1.0.0.post10-py3-none-any.whl |
|---|---|
| Size | 53.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
33368261cd11a69735f837651fa86a45feb9738650f52caf3d138bae14bdb845
|
|
BLAKE2b-256 checksum How to use checksums |
ced07baf610173abfaa0303890c5697e584629df830aa614ae8ddcff297c11b2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.11
|
Security for usf-agents 1.0.0.post10
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.