Skip to main content

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@tool decorator with agent_only, llm_only, or both visibility
  • 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

fipsagents-0.7.0.tar.gz (122.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fipsagents-0.7.0-py3-none-any.whl (90.7 kB view details)

Uploaded Python 3

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

Hashes for fipsagents-0.7.0.tar.gz
Algorithm Hash digest
SHA256 9108241365ef03beb505d07aa09d603b71589f85b76d0c13f581cc8a5349dce6
MD5 55e6c3f02e8bf94c0ca56f1da3bacb52
BLAKE2b-256 79039a830105bccf62e190d77e746562b181081d1e3dde716d64d3b7eab739de

See more details on using hashes here.

Provenance

The following attestation bundles were made for fipsagents-0.7.0.tar.gz:

Publisher: publish.yml on fips-agents/agent-template

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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

Hashes for fipsagents-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f21dec86f57b9cf6916dc80d98245b058113be9e382513b9dc60972b9a3c273b
MD5 6853e92693810b8a9aabcaf11c19e9ec
BLAKE2b-256 f64c30470d9459126b8184eb780bfd35907db424f681b3d2d1799fc57b59322a

See more details on using hashes here.

Provenance

The following attestation bundles were made for fipsagents-0.7.0-py3-none-any.whl:

Publisher: publish.yml on fips-agents/agent-template

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page