diff --git a/.go-version b/.go-version
new file mode 100644
index 00000000..d2ab029d
--- /dev/null
+++ b/.go-version
@@ -0,0 +1 @@
+1.21
diff --git a/README.md b/README.md
index fe28eade..e858d29c 100644
--- a/README.md
+++ b/README.md
@@ -1,22 +1,80 @@
-# Glide - An LLM Routing Engine
-Achieve 100% uptime for your Generative AI applications. Glide sits between your applications and your API endpoint. Pass your model preferences to the API endpoint and your call will be routed to the correct model based on model availability.
+# Glide
+<div style="text-align: center;">
+ <img src="docs/images/glide.png" width="400px" alt="Glide GH Header" />
+</div>
+[](https://github.com/modelgateway/glide/blob/main/LICENSE)
+Glide is a cloud-native open source high-performant model gateway. All LLMOps you needed is packed in one lightweight service.
+
+We take all problems and toll of managing and communicating with external providers out of your applications,
+so you could focus solving your core problems.
+
+Glide sits between your application and model providers that you use to seamlessly handle various LLMOps tasks like
+model failover, caching, etc.
+
+> [!Warning]
+> Glide is under active development right now. Give us a star to support the project ✨
+
+## Features
+
+- **Unified REST API** across providers. Avoid vendor lock-ins and changes in your applications when you adopt new providers.
+- **High availability** and **resiliency** working with external model providers. Automatic **fallbacks** on provider failures, rate limits, transient errors. Smart retries to reduce communication latency.
+- Support **popular LLM providers**.
+- **High performance**. Performance is our priority. We want to keep Glide "invisible" for your latency-wise, while providing rich functionality.
+- **Production-ready observability** via OpenTelemetry, emit metrics on models health, allows whitebox monitoring.
+- Straightforward and simple maintenance and configuration, API key rotation, etc.
## Supported Providers
-|| Provider | Support Status
-|---|---|---|
-| <img src="docs/images/openai.png" width=18 />| OpenAI | 🏗️ Coming Soon |
-| <img src="docs/images/azure.png" width=18>| Azure OpenAI | 🏗️ Coming Soon |
-| <img src="docs/images/anthropic.png" width=18>| Anthropic | 🏗️ Coming Soon |
-| <img src="docs/images/cohere.png" width=18>| Cohere | 🏗️ Coming Soon|
-| <img src="docs/images/bard.png" width=18>| Google Gemini | 🏗️ Coming Soon | |
-| <img src="docs/images/localai.png" width=18>| LocalAI | 🏗️ Coming Soon | |
+### Large Language Models
-<br />
+| | Provider | Support Status |
+|-----------------------------------------------------|---------------|-----------------|
+| <img src="docs/images/openai.svg" width="18" /> | OpenAI | 🏗️ Coming Soon |
+| <img src="docs/images/azure.svg" width="18" /> | Azure OpenAI | 🏗️ Coming Soon |
+| <img src="docs/images/anthropic.svg" width="18" /> | Anthropic | 🏗️ Coming Soon |
+| <img src="docs/images/cohere.png" width="18" /> | Cohere | 🏗️ Coming Soon |
+| <img src="docs/images/bard.svg" width="18" /> | Google Gemini | 🏗️ Coming Soon |
+| <img src="docs/images/localai.webp" width="18" /> | LocalAI | 🏗️ Coming Soon |
+
+
+## Get Started
+
+TBU
## Roadmap
-- REST API to set primary and secondary models based on LLM API status
-- Open an issue if there is a feature you'd like to see
+### MVP (Coming soon)
+
+- Unified LLM Chat REST API
+- Support for most popular LLM providers
+- Seamless model fallbacking
+- The Main Load Balancing: Priority, Round Robin, Weighted Round Robin, Latency
+
+### Future
+
+- Exact & Semantic Caching
+- Cost Management & Budgeting
+- and many more!
+
+Open [an issue](https://github.com/modelgateway/glide/issues) or start [a discussion](https://github.com/modelgateway/glide/discussions)
+if there is a feature or an enhancement you'd like to see in Glide.
+
+## Community
+
+- Join Discord for real-time discussions
+
+## Contribute
+
+- Maintainers
+
+ - [Roman Hlushko](https://github.com/roma-glushko), Software Engineer, Distributed Systems & MLOps
+ - [Max Krueger](https://github.com/mkrueger12), Data Engineer, Data Scientist
+
+Thanks everyone for already put their effort to make Glide better and more feature-rich:
+
+<a href="https://github.com/modelgateway/glide/graphs/contributors">
+ <img src="https://contributors-img.web.app/image?repo=modelgateway/glide" />
+</a>
+
diff --git a/docs/images/anthropic.svg b/docs/images/anthropic.svg
new file mode 100644
index 00000000..1702fb45
--- /dev/null
+++ b/docs/images/anthropic.svg
@@ -0,0 +1,8 @@
+<svg version="1.2" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 940 655" width="940" height="655">
+ <title>anthropic_BIG copy-svg</title>
+ <style>
+ .s0 { fill: #181818 }
+ </style>
+ <path id="Layer" class="s0" d="m536.5 1.3l260 653.6h142.5l-260-653.6z"/>
+ <path id="Layer" fill-rule="evenodd" class="s0" d="m259.7 0.5h149.1l259.7 653.6h-145.3l-53.1-137.2h-271.7l-53.2 137.2h-145.2zm-14.4 394.9h178l-89-229.7z"/>
+</svg>
\ No newline at end of file
diff --git a/docs/images/azure.svg b/docs/images/azure.svg
new file mode 100644
index 00000000..445315a5
--- /dev/null
+++ b/docs/images/azure.svg
@@ -0,0 +1 @@
+<svg height="2359" width="2500" xmlns="http://www.w3.org/2000/svg" viewBox="-0.4500000000000005 0.38 800.8891043012813 754.2299999999999"><linearGradient id="a" gradientUnits="userSpaceOnUse" x1="353.1" x2="107.1" y1="56.3" y2="783"><stop offset="0" stop-color="#114a8b"/><stop offset="1" stop-color="#0669bc"/></linearGradient><linearGradient id="b" gradientUnits="userSpaceOnUse" x1="429.8" x2="372.9" y1="394.9" y2="414.2"><stop offset="0" stop-opacity=".3"/><stop offset=".1" stop-opacity=".2"/><stop offset=".3" stop-opacity=".1"/><stop offset=".6" stop-opacity=".1"/><stop offset="1" stop-opacity="0"/></linearGradient><linearGradient id="c" gradientUnits="userSpaceOnUse" x1="398.4" x2="668.4" y1="35.1" y2="754.4"><stop offset="0" stop-color="#3ccbf4"/><stop offset="1" stop-color="#2892df"/></linearGradient><path d="M266.71.4h236.71L257.69 728.9a37.8 37.8 0 0 1-5.42 10.38c-2.33 3.16-5.14 5.93-8.33 8.22s-6.71 4.07-10.45 5.27-7.64 1.82-11.56 1.82H37.71c-5.98 0-11.88-1.42-17.2-4.16A37.636 37.636 0 0 1 7.1 738.87a37.762 37.762 0 0 1-6.66-16.41c-.89-5.92-.35-11.97 1.56-17.64L230.94 26.07c1.25-3.72 3.08-7.22 5.42-10.38 2.33-3.16 5.15-5.93 8.33-8.22 3.19-2.29 6.71-4.07 10.45-5.27S262.78.38 266.7.38v.01z" fill="url(#a)"/><path d="M703.07 754.59H490.52c-2.37 0-4.74-.22-7.08-.67-2.33-.44-4.62-1.1-6.83-1.97s-4.33-1.95-6.34-3.21a38.188 38.188 0 0 1-5.63-4.34l-241.2-225.26a17.423 17.423 0 0 1-5.1-8.88 17.383 17.383 0 0 1 7.17-18.21c2.89-1.96 6.3-3.01 9.79-3.01h375.36l92.39 265.56z" fill="#0078d4"/><path d="M504.27.4l-165.7 488.69 270.74-.06 92.87 265.56H490.43c-2.19-.02-4.38-.22-6.54-.61s-4.28-.96-6.34-1.72a38.484 38.484 0 0 1-11.36-6.51L303.37 593.79l-45.58 134.42c-1.18 3.36-2.8 6.55-4.82 9.48a40.479 40.479 0 0 1-16.05 13.67 40.03 40.03 0 0 1-10.13 3.23H37.82c-6.04.02-12-1.42-17.37-4.2A37.664 37.664 0 0 1 .43 722a37.77 37.77 0 0 1 1.87-17.79L230.87 26.58c1.19-3.79 2.98-7.36 5.3-10.58 2.31-3.22 5.13-6.06 8.33-8.4s6.76-4.16 10.53-5.38S262.75.38 266.72.4h237.56z" fill="url(#b)"/><path d="M797.99 704.82a37.847 37.847 0 0 1 1.57 17.64 37.867 37.867 0 0 1-6.65 16.41 37.691 37.691 0 0 1-30.61 15.72H498.48c5.98 0 11.88-1.43 17.21-4.16 5.32-2.73 9.92-6.7 13.41-11.56s5.77-10.49 6.66-16.41.35-11.97-1.56-17.64L305.25 26.05a37.713 37.713 0 0 0-13.73-18.58c-3.18-2.29-6.7-4.06-10.43-5.26S273.46.4 269.55.4h263.81c3.92 0 7.81.61 11.55 1.81 3.73 1.2 7.25 2.98 10.44 5.26 3.18 2.29 5.99 5.06 8.32 8.21s4.15 6.65 5.41 10.37l228.95 678.77z" fill="url(#c)"/></svg>
\ No newline at end of file
diff --git a/docs/images/bard.svg b/docs/images/bard.svg
new file mode 100644
index 00000000..4a943308
--- /dev/null
+++ b/docs/images/bard.svg
@@ -0,0 +1,22 @@
+<svg width="1080" height="1080" viewBox="0 0 1080 1080" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M515.09 725.824L472.006 824.503C455.444 862.434 402.954 862.434 386.393 824.503L343.308 725.824C304.966 638.006 235.953 568.104 149.868 529.892L31.2779 477.251C-6.42601 460.515 -6.42594 405.665 31.2779 388.929L146.164 337.932C234.463 298.737 304.714 226.244 342.401 135.431L386.044 30.2693C402.239 -8.75637 456.159 -8.75646 472.355 30.2692L515.998 135.432C553.685 226.244 623.935 298.737 712.234 337.932L827.121 388.929C864.825 405.665 864.825 460.515 827.121 477.251L708.53 529.892C622.446 568.104 553.433 638.006 515.09 725.824Z" fill="url(#paint0_radial_2525_777)"/>
+<path d="M915.485 1036.98L903.367 1064.75C894.499 1085.08 866.349 1085.08 857.481 1064.75L845.364 1036.98C823.765 987.465 784.862 948.042 736.318 926.475L698.987 909.889C678.802 900.921 678.802 871.578 698.987 862.61L734.231 846.951C784.023 824.829 823.623 783.947 844.851 732.75L857.294 702.741C865.966 681.826 894.882 681.826 903.554 702.741L915.997 732.75C937.225 783.947 976.826 824.829 1026.62 846.951L1061.86 862.61C1082.05 871.578 1082.05 900.921 1061.86 909.889L1024.53 926.475C975.987 948.042 937.083 987.465 915.485 1036.98Z" fill="url(#paint1_radial_2525_777)"/>
+<defs>
+<radialGradient id="paint0_radial_2525_777" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(670.447 474.006) rotate(78.858) scale(665.5 665.824)">
+<stop stop-color="#1BA1E3"/>
+<stop offset="0.0001" stop-color="#1BA1E3"/>
+<stop offset="0.300221" stop-color="#5489D6"/>
+<stop offset="0.545524" stop-color="#9B72CB"/>
+<stop offset="0.825372" stop-color="#D96570"/>
+<stop offset="1" stop-color="#F49C46"/>
+</radialGradient>
+<radialGradient id="paint1_radial_2525_777" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(670.447 474.006) rotate(78.858) scale(665.5 665.824)">
+<stop stop-color="#1BA1E3"/>
+<stop offset="0.0001" stop-color="#1BA1E3"/>
+<stop offset="0.300221" stop-color="#5489D6"/>
+<stop offset="0.545524" stop-color="#9B72CB"/>
+<stop offset="0.825372" stop-color="#D96570"/>
+<stop offset="1" stop-color="#F49C46"/>
+</radialGradient>
+</defs>
+</svg>
diff --git a/docs/images/cohere.png b/docs/images/cohere.png
new file mode 100644
index 00000000..3da0b837
Binary files /dev/null and b/docs/images/cohere.png differ
diff --git a/docs/images/glide.png b/docs/images/glide.png
new file mode 100644
index 00000000..48eb15a8
Binary files /dev/null and b/docs/images/glide.png differ
diff --git a/docs/images/localai.webp b/docs/images/localai.webp
new file mode 100644
index 00000000..7dbad578
Binary files /dev/null and b/docs/images/localai.webp differ
diff --git a/docs/images/openai.svg b/docs/images/openai.svg
new file mode 100644
index 00000000..7ca399ea
--- /dev/null
+++ b/docs/images/openai.svg
@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M22.282 9.821a5.985 5.985 0 0 0-.516-4.91 6.046 6.046 0 0 0-6.51-2.9A6.065 6.065 0 0 0 4.981 4.18a5.985 5.985 0 0 0-3.998 2.9 6.046 6.046 0 0 0 .743 7.097 5.98 5.98 0 0 0 .51 4.911 6.051 6.051 0 0 0 6.515 2.9A5.985 5.985 0 0 0 13.26 24a6.056 6.056 0 0 0 5.772-4.206 5.99 5.99 0 0 0 3.997-2.9 6.056 6.056 0 0 0-.747-7.073zM13.26 22.43a4.476 4.476 0 0 1-2.876-1.04l.141-.081 4.779-2.758a.795.795 0 0 0 .392-.681v-6.737l2.02 1.168a.071.071 0 0 1 .038.052v5.583a4.504 4.504 0 0 1-4.494 4.494zM3.6 18.304a4.47 4.47 0 0 1-.535-3.014l.142.085 4.783 2.759a.771.771 0 0 0 .78 0l5.843-3.369v2.332a.08.08 0 0 1-.033.062L9.74 19.95a4.5 4.5 0 0 1-6.14-1.646zM2.34 7.896a4.485 4.485 0 0 1 2.366-1.973V11.6a.766.766 0 0 0 .388.676l5.815 3.355-2.02 1.168a.076.076 0 0 1-.071 0l-4.83-2.786A4.504 4.504 0 0 1 2.34 7.872zm16.597 3.855l-5.833-3.387L15.119 7.2a.076.076 0 0 1 .071 0l4.83 2.791a4.494 4.494 0 0 1-.676 8.105v-5.678a.79.79 0 0 0-.407-.667zm2.01-3.023l-.141-.085-4.774-2.782a.776.776 0 0 0-.785 0L9.409 9.23V6.897a.066.066 0 0 1 .028-.061l4.83-2.787a4.5 4.5 0 0 1 6.68 4.66zm-12.64 4.135l-2.02-1.164a.08.08 0 0 1-.038-.057V6.075a4.5 4.5 0 0 1 7.375-3.453l-.142.08L8.704 5.46a.795.795 0 0 0-.393.681zm1.097-2.365l2.602-1.5 2.607 1.5v2.999l-2.597 1.5-2.607-1.5z"/></svg>
\ No newline at end of file