---
## What is Agenta?
Agenta is a platform for building production-grade LLM applications. It helps **engineering** and **product teams** create reliable LLM apps faster through integrated prompt management, evaluation, and observability.
## Core Features
### ๐งช Prompt Management & Prompt Engineering
Collaborate with Subject Matter Experts (SMEs) on prompt engineering and make sure nothing breaks in production.
- **Interactive LLM Playground**: Compare prompts side by side against your test cases
- **Multi-Model Support**: Experiment with 50+ LLM models or [bring-your-own models](https://agenta.ai/docs/prompt-engineering/playground/custom-providers?utm_source=github&utm_medium=referral&utm_campaign=readme)
- **Version Control**: Version prompts and configurations with branching and environments
- **Complex Configurations**: Enable SMEs to collaborate on [complex configuration schemas](https://agenta.ai/docs/custom-workflows/overview?utm_source=github&utm_medium=referral&utm_campaign=readme) beyond simple prompts
[Explore prompt management โ](https://agenta.ai/docs/prompt-engineering/concepts?utm_source=github&utm_medium=referral&utm_campaign=readme)
### ๐ LLM Evaluation
Evaluate your LLM applications systematically with both human and automated feedback.
- **Flexible Testsets**: Create testcases from production data, playground experiments, or upload CSVs
- **Pre-built and Custom Evaluators**: Use LLM-as-judge, one of our 20+ pre-built evaluators, or your custom evaluators
- **UI and API Access**: Run evaluations via UI (for SMEs) or programmatically (for engineers)
- **Human Feedback Integration**: Collect and incorporate expert annotations
[Explore evaluation frameworks โ](https://agenta.ai/docs/evaluation/overview?utm_source=github&utm_medium=referral&utm_campaign=readme)
### ๐ก LLM Observability
Get visibility into your LLM applications in production.
- **Cost & Performance Tracking**: Monitor spending, latency, and usage patterns
- **LLM Tracing**: Debug complex workflows with detailed traces
- **Open Standards**: OpenTelemetry native tracing compatible with OpenLLMetry, and OpenInference
- **Integrations**: Comes with pre-built integrations for most models and frameworks
[Learn about observability โ](https://agenta.ai/docs/observability/overview?utm_source=github&utm_medium=referral&utm_campaign=readme)
## ๐ธ Screenshots
## ๐ Getting Started
### Agenta Cloud (Recommended):
The easiest way to get started is through Agenta Cloud. Free tier available with no credit card required.
### Self-hosting Agenta
1. Clone Agenta:
```bash
git clone https://github.com/Agenta-AI/agenta && cd agenta
```
2. Copy configuration:
Before starting the services, create the environment file from the example:
```bash
cp hosting/docker-compose/oss/env.oss.gh.example hosting/docker-compose/oss/.env.oss.gh
```
3. Start Agenta services:
```bash
docker compose -f hosting/docker-compose/oss/docker-compose.gh.yml --env-file hosting/docker-compose/oss/.env.oss.gh --profile with-web --profile with-traefik up -d
```
4. Access Agenta at `http://localhost`.
For deploying on a remote host, or using different ports refer to our [self-hosting](https://agenta.ai/docs/self-host/quick-start?utm_source=github&utm_medium=referral&utm_campaign=readme) and [remote deployment documentation](https://agenta.ai/docs/self-host/guides/deploy-remotely?utm_source=github&utm_medium=referral&utm_campaign=readme).
## ๐ฌ Community
Find help, explore resources, or get involved:
### ๐งฐ Support
- **๐ [Documentation](https://agenta.ai/docs/?utm_source=github&utm_medium=referral&utm_campaign=readme)** โ Full guides and API reference
- **๐ [Changelog](https://agenta.ai/docs/changelog?utm_source=github&utm_medium=referral&utm_campaign=readme)** โ Track recent updates
- **๐ฌ [Slack Community](https://join.slack.com/t/agenta-hq/shared_invite/zt-37pnbp5s6-mbBrPL863d_oLB61GSNFjw)** โ Ask questions and get support
### ๐ค Contribute
We welcome contributions of all kinds, from filing issues and sharing ideas to improving the codebase. Check out our [CONTRIBUTING.md](CONTRIBUTING.md) and:
- **๐ [Report bugs](https://github.com/Agenta-AI/agenta/issues)** โ Help us by reporting problems you encounter
- **๐ก [Share ideas and feedback](https://github.com/Agenta-AI/agenta/discussions)** โ Suggest features or vote on ideas
- **๐ง [Contribute to the codebase](https://agenta.ai/docs/contributing/overview?utm_source=github&utm_medium=referral&utm_campaign=readme)** โ Read the guide and open a pull request
## โญ Star Agenta
**Consider giving us a star!** It helps us grow our community and gets Agenta in front of more developers.
## Contributors โจ
[](#contributors-)
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind are welcome!
## Disabling Anonymized Tracking
By default, Agenta automatically reports anonymized basic usage statistics. This helps us understand how Agenta is used and track its overall usage and growth. This data does not include any sensitive information. To disable anonymized telemetry set `AGENTA_TELEMETRY_ENABLED` to `false` in your `.env` file.
