Production-ready AI agent framework for FIPS/OpenShift environments
Project description
fipsagents
Production-ready AI agent framework for FIPS/OpenShift environments. Provides BaseAgent — a pure Python, async-first base class that handles LLM communication, tool dispatch, MCP connections, prompt loading, skill management, configuration, and lifecycle so your agent subclass stays small.
Install
pip install fipsagents
With optional MemoryHub support:
pip install fipsagents[memory]
Quick start
from fipsagents.baseagent import BaseAgent, StepResult
class MyAgent(BaseAgent):
async def step(self) -> StepResult:
response = await self.call_model()
return StepResult.done(response.content)
import asyncio
asyncio.run(MyAgent().start())
What's included
- LLM client via litellm — one interface for 100+ providers (vLLM, LlamaStack, OpenAI, Anthropic, Azure, Bedrock)
- Two-plane tool system —
@tooldecorator withagent_only,llm_only, orbothvisibility - MCP client via FastMCP v3 — connect to remote tool servers
- Prompt loading — Markdown with YAML frontmatter
- Skills — agentskills.io progressive disclosure
- Configuration — YAML with
${VAR:-default}env var substitution - MemoryHub — optional persistent memory (dual-path: MCP for LLM, SDK for agent code)
- Protective patterns — max iterations, exponential backoff, rate limiting
Used by
This package is the shared framework for templates scaffolded by the fips-agents CLI:
- agent-loop — single-agent loop (
step()in a loop) - workflow — directed graph of nodes with typed state
License
Apache 2.0
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file fipsagents-0.7.0.tar.gz.
File metadata
- Download URL: fipsagents-0.7.0.tar.gz
- Upload date:
- Size: 122.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9108241365ef03beb505d07aa09d603b71589f85b76d0c13f581cc8a5349dce6
|
|
| MD5 |
55e6c3f02e8bf94c0ca56f1da3bacb52
|
|
| BLAKE2b-256 |
79039a830105bccf62e190d77e746562b181081d1e3dde716d64d3b7eab739de
|
Provenance
The following attestation bundles were made for fipsagents-0.7.0.tar.gz:
Publisher:
publish.yml on fips-agents/agent-template
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
fipsagents-0.7.0.tar.gz -
Subject digest:
9108241365ef03beb505d07aa09d603b71589f85b76d0c13f581cc8a5349dce6 - Sigstore transparency entry: 1355607603
- Sigstore integration time:
-
Permalink:
fips-agents/agent-template@e2972e372023674f716ba5859c30a58187ea03a9 -
Branch / Tag:
refs/tags/fipsagents-v0.7.0 - Owner: https://github.com/fips-agents
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@e2972e372023674f716ba5859c30a58187ea03a9 -
Trigger Event:
push
-
Statement type:
File details
Details for the file fipsagents-0.7.0-py3-none-any.whl.
File metadata
- Download URL: fipsagents-0.7.0-py3-none-any.whl
- Upload date:
- Size: 90.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f21dec86f57b9cf6916dc80d98245b058113be9e382513b9dc60972b9a3c273b
|
|
| MD5 |
6853e92693810b8a9aabcaf11c19e9ec
|
|
| BLAKE2b-256 |
f64c30470d9459126b8184eb780bfd35907db424f681b3d2d1799fc57b59322a
|
Provenance
The following attestation bundles were made for fipsagents-0.7.0-py3-none-any.whl:
Publisher:
publish.yml on fips-agents/agent-template
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
fipsagents-0.7.0-py3-none-any.whl -
Subject digest:
f21dec86f57b9cf6916dc80d98245b058113be9e382513b9dc60972b9a3c273b - Sigstore transparency entry: 1355607608
- Sigstore integration time:
-
Permalink:
fips-agents/agent-template@e2972e372023674f716ba5859c30a58187ea03a9 -
Branch / Tag:
refs/tags/fipsagents-v0.7.0 - Owner: https://github.com/fips-agents
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@e2972e372023674f716ba5859c30a58187ea03a9 -
Trigger Event:
push
-
Statement type: