Agents require a paid Pinata plan. Upgrade here.
Quick Start
1. Add an LLM Provider Key
Your agent needs an LLM provider to run. Add one of these as a secret first:ANTHROPIC_API_KEYOPENAI_API_KEYOPENROUTER_API_KEY
2. Create an Agent
Open agents.pinata.cloud and click Create Agent. Step 1: Identity — Choose a personality preset (Atlas, Nova, Sage) or create a custom one. Enter a name and optional description. Step 2: Workspace — The default Pinata workspace includes Node.js, Python, and common tools. Optionally add skills. Step 3: Connect — Select your LLM provider (shows “Available” when the key exists). Add any additional secrets your agent needs. Optionally configure channels. Step 4: Deploy — Click Deploy Agent. Once provisioning completes, you’re redirected to your agent’s detail page.Agent Detail Page
The sidebar provides access to all agent features:| Section | Purpose |
|---|---|
| Chat | Conversation interface |
| Channels | Messaging platform connections |
| Snapshots | Workspace versions and git access |
| Skills | Attached skill packages |
| Secrets | Environment variables |
| Routes | Port forwarding and domains |
| Tasks | Scheduled jobs |
Git Access
Clone and edit your agent’s workspace directly:Next Steps
Routes
Expose services to the internet
Channels
Connect messaging platforms
Skills
Extend agent capabilities
Secrets
Manage credentials