# openlit **Repository Path**: qzl9999/openlit ## Basic Information - **Project Name**: openlit - **Description**: https://github.com/openlit/openlit - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-08-15 - **Last Updated**: 2026-01-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
OpenLIT Logo #### Observability, Evaluations, Guardrails, Prompts, Vault, Playground, FleetHub # Open Source Platform for AI Engineering **[Documentation](https://docs.openlit.io/) | [Quickstart](-getting-started-with-llm-observability) | [Python SDK](https://github.com/openlit/openlit/tree/main/sdk/python) | [Typescript SDK](https://github.com/openlit/openlit/tree/main/sdk/typescript) |** **❤️ [Sponsor this project](https://opencollective.com/openlit) ❤️** [![OpenLIT](https://img.shields.io/badge/OpenLIT-orange)](https://openlit.io/) [![License](https://img.shields.io/github/license/openlit/openlit?label=License&logo=github&color=f80&logoColor=white)](https://github.com/openlit/openlit/blob/main/LICENSE) [![Downloads](https://static.pepy.tech/badge/openlit/month)](https://pepy.tech/project/openlit) [![GitHub Last Commit](https://img.shields.io/github/last-commit/openlit/openlit)](https://github.com/openlit/openlit/pulse) [![GitHub Contributors](https://img.shields.io/github/contributors/openlit/openlit)](https://github.com/openlit/openlit/graphs/contributors) [![Slack](https://img.shields.io/badge/Slack-4A154B?logo=slack&logoColor=white)](https://join.slack.com/t/openlit/shared_invite/zt-2etnfttwg-TjP_7BZXfYg84oAukY8QRQ) [![X](https://img.shields.io/badge/follow-%40openlit__io-1DA1F2?logo=x&style=social)](https://twitter.com/openlit_io)
--- **OpenLIT** allows you to simplify your AI development workflow, especially for Generative AI and LLMs. It streamlines essential tasks like experimenting with LLMs, organizing and versioning prompts, and securely handling API keys. With just one line of code, you can enable **OpenTelemetry-native** observability, offering full-stack monitoring that includes LLMs, vector databases, and GPUs. This enables developers to confidently build AI features and applications, transitioning smoothly from testing to production. This project proudly follows and maintains the [Semantic Conventions](https://github.com/open-telemetry/semantic-conventions/tree/main/docs/gen-ai) with the OpenTelemetry community, consistently updating to align with the latest standards in Observability. ## ⚡ Features ![OpenLIT Banner](https://github.com/openlit/.github/blob/main/profile/assets/openlit-feature-banner.png?raw=true) - 📈 **Analytics Dashboard**: Monitor your AI application's health and performance with detailed dashboards that track metrics, costs, and user interactions, providing a clear view of overall efficiency. - 🔌 **OpenTelemetry-native Observability SDKs**: Vendor-neutral SDKs to send traces and metrics to your existing observability tools. - 💲 **Cost Tracking for Custom and Fine-Tuned Models**: Tailor cost estimations for specific models using custom pricing files for precise budgeting. - 🐛 **Exceptions Monitoring Dashboard**: Quickly spot and resolve issues by tracking common exceptions and errors with a dedicated monitoring dashboard. - 💭 **Prompt Management**: Manage and version prompts using Prompt Hub for consistent and easy access across applications. - 🔑 **API Keys and Secrets Management**: Securely handle your API keys and secrets centrally, avoiding insecure practices. - 🎮 **Experiment with different LLMs**: Use OpenGround to explore, test and compare various LLMs side by side. - 🚀 **Fleet Hub for OpAMP Management**: Centrally manage and monitor OpenTelemetry Collectors across your infrastructure using the OpAMP (Open Agent Management Protocol) with secure TLS communication. ## 🚀 Getting Started with LLM Observability ```mermaid flowchart TB; subgraph " " direction LR; subgraph " " direction LR; OpenLIT_SDK[OpenLIT SDK] -->|Sends Traces & Metrics| OTC[OpenTelemetry Collector]; OTC -->|Stores Data| ClickHouseDB[ClickHouse]; end subgraph " " direction RL; OpenLIT_UI[OpenLIT] -->|Pulls Data| ClickHouseDB; end end ``` ### Step 1: Deploy OpenLIT Stack 1. Git Clone OpenLIT Repository Open your command line or terminal and run: ```shell git clone git@github.com:openlit/openlit.git ``` 2. Self-host using Docker Deploy and run OpenLIT with the following command: ```shell docker compose up -d ``` > For instructions on installing in Kubernetes using Helm, refer to the [Kubernetes Helm installation guide](https://docs.openlit.io/latest/openlit/installation#kubernetes). ### Step 2: Install OpenLIT SDK Open your command line or terminal and run: ```bash pip install openlit ``` > For instructions on using the TypeScript SDK, visit the [TypeScript SDK Installation guide](https://github.com/openlit/openlit/tree/main/sdk/typescript#-installation). ### Step 3: Initialize OpenLIT in your Application Integrate OpenLIT into your AI applications by adding the following lines to your code. ```python import openlit openlit.init() ``` Configure the telemetry data destination as follows: | Purpose | Parameter/Environment Variable | For Sending to OpenLIT | | ---------------------------------- | ------------------------------------------------ | ------------------------- | | Send data to an HTTP OTLP endpoint | `otlp_endpoint` or `OTEL_EXPORTER_OTLP_ENDPOINT` | `"http://127.0.0.1:4318"` | | Authenticate telemetry backends | `otlp_headers` or `OTEL_EXPORTER_OTLP_HEADERS` | Not required by default | > 💡 Info: If the `otlp_endpoint` or `OTEL_EXPORTER_OTLP_ENDPOINT` is not provided, the OpenLIT SDK will output traces directly to your console, which is recommended during the development phase. #### Example ---
Initialize using Function Arguments Add the following two lines to your application code: ```python import openlit openlit.init( otlp_endpoint="http://127.0.0.1:4318", ) ```
---
--- Initialize using Environment Variables Add the following two lines to your application code: ```python import openlit openlit.init() ``` Then, configure the your OTLP endpoint using environment variable: ```env export OTEL_EXPORTER_OTLP_ENDPOINT = "http://127.0.0.1:4318" ```
--- ### Step 4: Visualize and Optimize With the Observability data now being collected and sent to OpenLIT, the next step is to visualize and analyze this data to get insights into your AI application's performance, behavior, and identify areas of improvement. Just head over to OpenLIT at `127.0.0.1:3000` on your browser to start exploring. You can login using the default credentials: - **Email**: `user@openlit.io` - **Password**: `openlituser` ![](https://github.com/openlit/.github/blob/main/profile/assets/openlit-client-1.png?raw=true) ![](https://github.com/openlit/.github/blob/main/profile/assets/openlit-client-2.png?raw=true) ## 🛣️ Roadmap We are dedicated to continuously improving OpenLIT. Here's a look at what's been accomplished and what's on the horizon: | Feature | Status | | --------------------------------------------------------------------------------------------------------------------------------- | ------------- | | [OpenTelemetry-native Observability SDK for Tracing and Metrics](https://github.com/openlit/openlit/tree/text-upgrade/sdk/python) | ✅ Completed | | [OpenTelemetry-native GPU Monitoring](https://docs.openlit.io/latest/features/gpu) | ✅ Completed | | [Exceptions and Error Monitoring](https://docs.openlit.io/latest/features/exceptions) | ✅ Completed | | [Prompt Hub for Managing and Versioning Prompts](https://docs.openlit.io/latest/features/prompt-hub) | ✅ Completed | | [OpenGround for Testing and Comparing LLMs](https://docs.openlit.io/latest/features/openground) | ✅ Completed | | [Vault for Central Management of LLM API Keys and Secrets](https://docs.openlit.io/latest/features/vault) | ✅ Completed | | [Cost Tracking for Custom Models](https://docs.openlit.io/latest/features/pricing) | ✅ Completed | | [Real-Time Guardrails Implementation](https://docs.openlit.io/latest/features/guardrails) | ✅ Completed | | [Programmatic Evaluation for LLM Response](https://docs.openlit.io/latest/features/evaluations) | ✅ Completed | | [Fleet Hub for OpAMP Management](https://docs.openlit.io/latest/openlit/observability/fleet-hub) | ✅ Completed | | [Auto-Evaluation Metrics Based on Usage](https://github.com/openlit/openlit/issues/470) | 🔜 Coming Soon | | [Human Feedback for LLM Events](https://github.com/openlit/openlit/issues/471) | 🔜 Coming Soon | | [Dataset Generation Based on LLM Events](https://github.com/openlit/openlit/issues/472) | 🔜 Coming Soon | | [Search over Traces]() | 🔜 Coming Soon | ## 🌱 Contributing Whether it's big or small, we love contributions 💚. Check out our [Contribution guide](./CONTRIBUTING.md) to get started Unsure where to start? Here are a few ways to get involved: - Join our [Slack](https://join.slack.com/t/openlit/shared_invite/zt-2etnfttwg-TjP_7BZXfYg84oAukY8QRQ) or [Discord](https://discord.gg/rjvTm6zd) community to discuss ideas, share feedback, and connect with both our team and the wider OpenLIT community. Your input helps us grow and improve, and we're here to support you every step of the way. [![OpenLIT - One click observability, evals for LLMs & GPUs | Product Hunt](https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=460690&theme=light)](https://www.producthunt.com/posts/openlit?embed=true&utm_source=badge-featured&utm_medium=badge&utm_souce=badge-openlit) Example Image ## 💚 Community & Support Connect with OpenLIT community and maintainers for support, discussions, and updates: - 🌟 If you like it, leave a star on our [GitHub](https://github.com/openlit/openlit/). - 🌍 Join our [Slack](https://join.slack.com/t/openlit/shared_invite/zt-2etnfttwg-TjP_7BZXfYg84oAukY8QRQ) or [Discord](https://discord.gg/CQnXwNT3) community for live interactions and questions. - 🐞 Report bugs on our [GitHub Issues](https://github.com/openlit/openlit/issues) to help us improve OpenLIT. - 𝕏 Follow us on [X](https://twitter.com/openlit_io) for the latest updates and news. ## License OpenLIT is available under the [Apache-2.0 license](LICENSE). ## 🙇‍♂️ Acknowledgments

This project is proudly supported by: