A lightweight client for managing Letta AI agents as Roblox NPCs.
pip install letta-robloxThe client supports two server types:
client = LettaRobloxClient(
host="localhost",
port=8333,
server_type="pip" # Default
)- Uses friendly agent names
- Accepts full ChatMemory structure
- Local timestamps
client = LettaRobloxClient(
host="localhost",
port=8283,
server_type="docker"
)- Uses timestamp-based names
- Requires simpler memory structure
- UTC timestamps
from letta import ChatMemory
from letta_roblox.client import LettaRobloxClient
# Works with both servers
client = LettaRobloxClient(port=8333) # or port=8283
agent = client.create_agent(
memory=ChatMemory(
human="Player info",
persona="NPC personality"
)
)# List agents
letta-manage --host localhost --port 8333 list
# Get agent details
letta-manage --host localhost --port 8333 get --id <agent-id>
# Delete agent
letta-manage --host localhost --port 8333 delete --id <agent-id>Version 0.2.0:
- Changed server URL handling to use host/port
- Added explicit server_type parameter
- Removed deprecated URL format
From 0.1.x:
# Old
client = LettaRobloxClient("http://localhost:8333")
# New
client = LettaRobloxClient(
host="localhost",
port=8333,
server_type="pip" # or "docker"
)