Resources
Frequently Asked Questions
Common questions about RunAgent
General Questions
What is RunAgent?
What is RunAgent?
RunAgent is a platform for deploying AI agents to production. It provides:
- Framework-agnostic deployment
- Automatic scaling and monitoring
- Simple CLI and SDK interfaces
- Support for all major AI frameworks
Which AI frameworks are supported?
Which AI frameworks are supported?
Currently supported:
- LangGraph
- CrewAI
- Agno
- Letta
- Custom Python frameworks
- AutoGen
- BabyAGI
- AgentGPT
How does pricing work?
How does pricing work?
Local deployment: Free foreverCloud deployment (coming soon):
- Free tier: 1,000 requests/month
- Pro: $29/month for 50,000 requests
- Enterprise: Custom pricing
Getting Started
How do I install RunAgent?
How do I install RunAgent?
Simply use pip:For development with all dependencies:
Do I need to rewrite my existing agent?
Do I need to rewrite my existing agent?
No! RunAgent works with your existing code. Just:
- Add a
runagent.config.jsonfile - Define your entrypoints
- Deploy
What are entrypoints?
What are entrypoints?
Entrypoints are functions RunAgent calls to interact with your agent:
Technical Questions
What Python versions are supported?
What Python versions are supported?
RunAgent supports Python 3.8 and above:
- Python 3.8
- Python 3.9
- Python 3.10
- Python 3.11
- Python 3.12
Can I use custom dependencies?
Can I use custom dependencies?
Yes! Add any dependencies to your RunAgent will install them during deployment.
requirements.txt:How do I handle secrets and API keys?
How do I handle secrets and API keys?
Local development: Use Production: Set in deployment configurationSecrets are encrypted at rest and never logged.
.env filesWhat are the resource limits?
What are the resource limits?
Default limits:
- Memory: 512MB (configurable up to 8GB)
- Timeout: 30 seconds (configurable up to 900s)
- Payload size: 10MB
- Concurrent requests: Based on plan
runagent.config.json:Deployment Questions
What's the difference between local and cloud deployment?
What's the difference between local and cloud deployment?
Local deployment:
- Runs on your machine
- Free forever
- Good for development and testing
- Requires your machine to be running
- Runs on RunAgent infrastructure
- Auto-scaling and high availability
- Monitoring and logging included
- Accessible from anywhere
How do I update a deployed agent?
How do I update a deployed agent?
Simply deploy again with the same name:RunAgent handles:
- Zero-downtime updates
- Automatic rollback on failure
- Version history
Can I deploy multiple versions?
Can I deploy multiple versions?
Yes! Use different names or environments:
SDK Questions
Which languages have SDKs?
Which languages have SDKs?
Available now:
- Python
- JavaScript/TypeScript (Q2 2024)
- Rust (Q2 2024)
- Go (Q3 2024)
How do I handle streaming responses?
How do I handle streaming responses?
Python SDK:Direct API:
Use Server-Sent Events (SSE) with appropriate client library.
Is the SDK thread-safe?
Is the SDK thread-safe?
Yes, the SDK clients are thread-safe. You can:
- Share a client instance across threads
- Use in async contexts with AsyncRunAgentClient
- Handle concurrent requests
Troubleshooting
My agent works locally but fails when deployed
My agent works locally but fails when deployed
Common causes:
- Missing environment variables - Check all are set
- File path issues - Use relative paths
- Dependency versions - Pin specific versions
- Resource limits - Increase memory/timeout
How do I debug performance issues?
How do I debug performance issues?
- Add logging to identify slow operations
- Use profiling to find bottlenecks
- Check logs for errors or warnings
- Monitor metrics (coming soon)
Best Practices
How should I structure my agent project?
How should I structure my agent project?
Recommended structure:
Should I use sync or async?
Should I use sync or async?
Use sync when:
- Simple request/response
- No concurrent operations
- Easier to debug
- Multiple API calls
- I/O intensive operations
- Need better performance
Community & Support
How do I get help?
How do I get help?
- Documentation: docs.run-agent.ai
- Discord: discord.gg/runagent
- GitHub Issues: For bugs and features
- Email: [email protected] for critical issues
Can I contribute to RunAgent?
Can I contribute to RunAgent?
Yes! We welcome contributions:
- Code contributions via GitHub
- Documentation improvements
- Bug reports and feature requests
- Community SDKs and templates
Is RunAgent open source?
Is RunAgent open source?
The RunAgent CLI and SDKs are open source (MIT license). The deployment infrastructure is proprietary but offers a generous free tier.
Still Have Questions?
Ask on Discord
Get help from the communityJoin Discord →
Contact Support
For account or billing questionsEmail Us →