$git clone https://github.com/TheLunarCompany/lunar</div>
| 1 | <div align="center"> |
| 2 | <img src="readme-files/logo-light.png#gh-light-mode-only" width="50%" height="50%" /> |
| 3 | <img src="readme-files/logo-dark.png#gh-dark-mode-only" width="50%" height="50%" /> |
| 4 | |
| 5 | <a href="https://opensource.org/licenses/MIT"></a> |
| 6 | <a href="https://docs.lunar.dev/"></a> |
| 7 | <a href="https://lunar.dev/"></a> |
| 8 | |
| 9 | </div> |
| 10 | |
| 11 | # Welcome to Lunar.dev |
| 12 | |
| 13 | **Lunar.dev** is an open-source platform for **managing, governing and optimizing** third-party API consumption across applications and AI agent workloads at scale. |
| 14 | |
| 15 | <div align="center"> |
| 16 | <img src="readme-files/lunar-flow-light.svg#gh-light-mode-only" > |
| 17 | <img src="readme-files/lunar-flow-dark.svg#gh-dark-mode-only" > |
| 18 | </div> |
| 19 | |
| 20 | ## Consumption Management for the AI Era |
| 21 | |
| 22 | As AI agents and autonomous workflows increasingly rely on external APIs, there's a growing need for a mediation layer that acts as a central aggregation point between applications, agents, and the services they depend on. |
| 23 | |
| 24 | Lunar.dev provides that layer—serving as a unified API Gateway for AI, delivering: |
| 25 | |
| 26 | - **Live API Traffic Visibility:** Get real-time metrics on latency, errors, cost, and token usage across all outbound traffic, including LLM and agent calls. |
| 27 | - **AI-Aware Policy Enforcement:** Control tool access, throttle agent actions, and govern agentic traffic with fine-grained rules. |
| 28 | - **Advanced Traffic Shaping:** Apply rate limits, retries, priority queues, and circuit breakers to manage load and ensure reliability. |
| 29 | - **Cost & Performance Optimization:** Identify waste, smooth traffic peaks, and reduce overuse of costly APIs through smart gateway policies. |
| 30 | - **Centralized MCP Aggregation:** Streamline operations by consolidating multiple MCP servers into a single gateway, enhancing security, observability, and management. |
| 31 | |
| 32 | ## Choose Your Path |
| 33 | |
| 34 | Lunar.dev is composed of two major components: |
| 35 | |
| 36 | - [**Lunar Proxy**](https://github.com/TheLunarCompany/lunar/tree/main/proxy#readme) – our core API gateway and control layer |
| 37 | - [**Lunar MCPX**](https://github.com/TheLunarCompany/lunar/tree/main/mcpx#readme) – a zero-code aggregator for multiple MCP servers with unified API access |
| 38 | |
| 39 | Explore the one that fits your needs—or use both for a full-stack solution. |
| 40 | |
| 41 | ## Open Source at the Core |
| 42 | |
| 43 | This project was born out of the need for a more robust, production-ready approach to managing third-party APIs. It remains open-source at its core and free for non-production/personal use. For production environments, we offer advanced features through guided onboarding and platform tiers; [visit our website](https://lunar.dev) or reach out directly for more information |