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
+
+
+
+[![LICENSE](https://img.shields.io/github/license/modelgateway/glide.svg?style=flat-square&color=%2362d0c6)](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
-|---|---|---|
-| | OpenAI | 🏗️ Coming Soon |
-| | Azure OpenAI | 🏗️ Coming Soon |
-| | Anthropic | 🏗️ Coming Soon |
-| | Cohere | 🏗️ Coming Soon|
-| | Google Gemini | 🏗️ Coming Soon | |
-| | LocalAI | 🏗️ Coming Soon | |
+### Large Language Models
-
+| | Provider | Support Status |
+|-----------------------------------------------------|---------------|-----------------|
+| | OpenAI | 🏗️ Coming Soon |
+| | Azure OpenAI | 🏗️ Coming Soon |
+| | Anthropic | 🏗️ Coming Soon |
+| | Cohere | 🏗️ Coming Soon |
+| | Google Gemini | 🏗️ Coming Soon |
+| | 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:
+
+
+
+
+
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 @@
+
\ 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 @@
+
\ 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 @@
+
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 @@
+
\ No newline at end of file