agent-file

Stale
GitHub TypeScript Apache-2.0

Description

Agent File (.af): An open file format for serializing stateful AI agents with persistent memory and behavior. Share, checkpoint, and version control agents across compatible frameworks.

Key Features

  • Open standard .af file format for serializing stateful AI agents with complete state
  • Packages all agent components: system prompts, editable memory blocks, tool configurations, and LLM settings
  • Cross-framework portability — agents can be seamlessly migrated and deployed between compatible systems
  • Multiple import/export methods: Python SDK, TypeScript SDK, REST API, and ADE GUI
  • Supports agent versioning and state snapshots for collaboration and archival
  • Includes a curated directory of pre-trained agents ready to use or contribute

Use Cases

💡 Export trained agents and share them with your team or the community
💡 Migrate agents between different AI frameworks for cross-platform deployment
💡 Version control agent configurations and track change history over time
💡 Quickly deploy pre-trained agents to a Letta Server via ADE, SDK, or API
💡 Use the ADE visual interface to import and export agent state with ease

Strengths & Limitations

Strengths

  • High community interest (1.2k stars)
  • Permissive open-source license (Apache-2.0)
  • Responsive to issues, low backlog

Quick Start

pip install letta-client>=1.0.0 then from letta_client import Letta; client = Letta(base_url='http://localhost:8283'); agent_state = client.agents.import_file(file=open('agent.af', 'rb'))

Related Projects