Agent File (.af) is an open standard file format designed to serialize stateful AI agents, enabling portability, sharing, and version control across compatible frameworks. It packages essential agent components like system prompts, memory, tool configurations, and LLM settings into a single, portable file. This format is beneficial for developers and researchers looking to streamline agent development, collaboration, and deployment.

How It Works

Agent File standardizes the serialization of agent state, including model configurations, message history, system prompts, memory blocks, tool rules, environment variables, and tool definitions (source code and schema). This comprehensive approach ensures that all necessary information to recreate an agent is contained within the .af file, facilitating seamless transfer and management of agent states.

Quick Start & Requirements

• Install/Run: Use curl, Python SDK (pip install letta-client), or Node.js SDK (npm install @letta-ai/letta-client) to import/export .af files with a running Letta Server.
• Prerequisites: A running Letta Server (Docker, Desktop, or Cloud). Some example agents require API keys (e.g., Tavily, Firecrawl, Composio).
• Resources: Example agents are provided for download.
• Links: Documentation, Community, GitHub.

Highlighted Details

• Supports serialization of system prompts, editable memory, tool configurations (code and schemas), and LLM settings.
• Enables seamless transfer between compatible frameworks, checkpointing, and version control of agent state.
• Includes example agents for MemGPT, Deep Research, Customer Support, Stateless Workflow, and Composio tools.
• Roadmap includes support for archival memory passages, data sources, and cross-framework converters.

Maintenance & Community

• Actively maintained by the Letta team and OSS contributors.
• Community support via Discord.
• GitHub repository for contributions and issues.

Licensing & Compatibility

• Licensed under Apache 2.0.
• Compatible with commercial use and closed-source linking. Secrets are nulled upon export for security.

Limitations & Caveats

Currently, Agent File does not support "Passages" (units of Archival Memory in Letta/MemGPT), though this is on the roadmap. Adapting .af files to frameworks lacking concepts like context window "blocks" may require per-framework adjustments.