Agent File
Agent File (.af): An open file format for serializing stateful AI agents with persistent memory and
Rating
Votes
0
score
Downloads
0
total
Price
Free
No login needed
Works With
About
Agent File (.af): An open file format for stateful agents.
[View .af Schema ] [Download .af Examples ] [Contributing ]
Agent File (`.af`) is an open standard file format for serializing stateful AI agents. Originally designed for the Letta framework, Agent File provides a portable way to share agents with persistent memory and behavior.
Agent Files package all components of a stateful agent: system prompts, editable memory (personality and user information), tool configurations (code and schemas), and LLM settings. By standardizing these elements in a single format, Agent File enables seamless transfer between compatible frameworks, while allowing for easy checkpointing and version control of agent state.
Browsing Agents
Each agent in this directory has been trained and tuned for specific purposes. You can explore them at:
agents/
└── @{owner}/
└── {agent-name}/
├── {agent-name}.af # The agent file
└── {agent-name}.webp # Avatar imageFeatured Agents
| Agent | Author | Description |
|---|---|---|
| Loop | @letta-ai | A ChatGPT alternative focused on memory. Direct, dry, remembers everything. |
Deploying an Agent
You can deploy any agent file to your own Letta server using the ADE, REST API, or SDK.
Using the Agent Development Environment (ADE)
- 1.Download the
.affile from this repository - 2.Open Letta ADE
- 3.Click "Import Agent" and select the file
Using the Python SDK
# Install SDK with `pip install letta-client>=1.0.0`
from letta_client import Letta
# Assuming a Letta Server is running at http://localhost:8283
client = Letta(base_url="http://localhost:8283")
# Import your .af file from any location
agent_state = client.agents.import_file(file=open("/path/to/agent/file.af", "rb"))
print(f"Imported agent: {agent_state.id}")Using the TypeScript SDK
// Install SDK with `npm install @letta-ai/letta-client@^1.0.0`
import { LettaClient } from '@letta-ai/letta-client'
import { readFileSync } from 'fs';
import { Blob } from 'buffer';
// Assuming a Letta Server is running at http://localhost:8283
const client = new LettaClient({ baseUrl: "http://localhost:8283" });
// Import your .af file from any location
const file = new Blob([readFileSync('/path/to/agent/file.af')])
const agentState = await client.agents.importFile(file, {})
console.log(`Imported agent: ${agentState.id}`);Using cURL
# Assuming a Letta Server is running at http://localhost:8283
curl -X POST "http://localhost:8283/v1/agents/import" -F "file=/path/to/agent/file.af"Contributing an Agent
Have an agent you've trained and want to share? We'd love to include it.
Don't lose this
Three weeks from now, you'll want Agent File again. Will you remember where to find it?
Save it to your library and the next time you need Agent File, it’s one tap away — from any AI app you use. Group it into a bench with the rest of the team for that kind of task and you can pull the whole stack at once.
⚡ Pro tip for geeks: add a-gnt 🤵🏻♂️ as a custom connector in Claude or a custom GPT in ChatGPT — one click and your library is right there in the chat. Or, if you’re in an editor, install the a-gnt MCP server and say “use my [bench name]” in Claude Code, Cursor, VS Code, or Windsurf.
a-gnt's Take
Our honest review
Agent File (.af): An open file format for serializing stateful AI agents with persistent memory and . Best for anyone looking to make their AI assistant more capable in communication. It's completely free and works across most major AI apps. This one just landed in the catalog — worth trying while it's fresh.
Tips for getting started
Tap "Get" above, pick your AI app, and follow the steps. Most installs take under 30 seconds.
What's New
Imported from GitHub
Ratings & Reviews
0.0
out of 5
0 ratings
No reviews yet. Be the first to share your experience.