diff --git a/README.md b/README.md
index 65fd2edcd8..7cb3edfc7f 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,16 @@
-# litellm
\ No newline at end of file
+# litellm
+a simple, fast, 100 line package to call OpenAI, Azure, Cohere, Anthropic API Endpoints 
+
+# usage
+```
+messages = [{ "content": "Hello, how are you?","role": "user"}]
+# openai call
+response = completion(model="gpt-3.5-turbo", messages=messages)
+
+# cohere call
+response = completion("command-nightly", messages)
+
+# azure openai call
+response = completion("chatgpt-test", messages, azure=True)
+```
+