diff --git a/README.md b/README.md
index 0655717b..6abffbf3 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,18 @@
-[![Crate](https://img.shields.io/crates/v/rig-core.svg)](https://crates.io/crates/rig-core)
+<p align="center">
+<img src="img/rig_logo.svg" alt="Rig Logo" style="width: 75%; height: 75%;"><br>
+<a href="https://crates.io/crates/rig-core"><img src="https://img.shields.io/crates/v/rig-core.svg" /></a>
+&nbsp;
+<a href="https://discord.gg/gkp6UqEUph"><img src="https://img.shields.io/discord/511303648119226382?color=%236d82cc&label=Discord&logo=discord&logoColor=white" /></a>
+&nbsp;
+<a href="https://github.com/surrealdb/surrealdb"><img src="https://img.shields.io/badge/built_with-Rust-dca282.svg" /></a>
+&nbsp;
+<a href="https://twitter.com/Playgrounds0x"><img src="https://img.shields.io/badge/twitter-follow_us-1d9bf0.svg?style=flat /"></a>
+&nbsp;
+<a href="https://github.com/surrealdb/license"><img src="https://img.shields.io/badge/license-MIT-00bfff.svg" /></a>
+</p>
+&nbsp;
 
-# Rig
+## What is Rig?
 Rig is a Rust library for building scalable, modular, and ergonomic LLM-powered applications.
 
 More information about this crate can be found in the [crate documentation](https://docs.rs/rig-core/latest/rig/).
@@ -9,9 +21,11 @@ We'd love your feedback. Please take a moment to let us know what you think usin
 
 ## Table of contents
 
+- [What is Rig?](#what-is-rig)
+- [Table of contents](#table-of-contents)
 - [High-level features](#high-level-features)
-- [Installation](#)
-- [Simple Example](#simple-example)
+- [Installation](#installation)
+- [Simple example:](#simple-example)
 - [Integrations](#integrations)
 
 ## High-level features
diff --git a/img/rig_logo.svg b/img/rig_logo.svg
new file mode 100644
index 00000000..be08ccc0
--- /dev/null
+++ b/img/rig_logo.svg
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0 0 1899 830">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: white;
+        stroke-width: 0px;
+      }
+    </style>
+  </defs>
+  <g>
+    <path class="cls-1"
+      d="M613.5,698h-154.5c-3.2,0-6.3-1.6-8.1-4.3l-93.7-135.7c-1.8-2.6-4.7-4.2-7.9-4.3l-22.9-.6c-5.3-.1-9.5-4.4-9.6-9.7l-1.8-110.3c0-5.5,4.3-10,9.8-10l57.8-.4c.4,0,.8,0,1.2,0,6.9-.9,71.8-11.5,72.7-76.5,1.1-76.8-68.7-85.6-74.9-86.2-.3,0-.6,0-.9,0l-57.5-.7c-5.4,0-9.7-4.4-9.7-9.8l-.4-98c0-11.5,9.3-20.8,20.8-20.8h80.3c.2,0,.4,0,.6,0,2.2.1,4.4.3,6.7.4,87.9,5.7,203.3,72.7,203.3,209.4s-74.2,164.3-100.9,179.5c-5,2.8-6.4,9.3-3.2,14.1l101.1,148.6c4.5,6.5-.2,15.4-8.2,15.4Z" />
+    <path class="cls-1"
+      d="M952.7,150.3v527.8c0,10.9-8.9,19.8-19.8,19.8h-110.8c-11.5,0-20.8-9.3-20.8-20.8V150.3c0-10.9,8.9-19.8,19.8-19.8h111.8c10.9,0,19.8,8.9,19.8,19.8Z" />
+    <rect class="cls-1" x="98.7" y="130.6" width="151.3" height="567.4" rx="20.8" ry="20.8" />
+  </g>
+  <path class="cls-1"
+    d="M1821.1,424.7c0-6-1.4-11.6-3.8-16.6-5.5-11.8-16.6-19.9-29.5-19.9h-130.7c-.7,0-1.5.1-2.1.2-.7,0-1.4-.2-2.1-.2h-138.6c-11,0-19.9,8.9-19.9,19.9v68.4c0,11,8.9,19.9,19.9,19.9h101.5c-7.3,13.2-16.5,25.7-27.7,37-47,47.7-115.2,61.7-174.8,41.9-23.9-8-46.3-21.3-65.5-40.2-63.3-62.4-67.4-162.3-11.5-229.5,3-3.7,6.3-7.2,9.7-10.7,65.8-66.9,173.4-67.7,240.3-1.8,7.7,7.7,14.6,15.9,20.6,24.6,3.7,5.4,9.9,8.6,16.5,8.6h99.2c14.5,0,24.4-14.8,18.7-28.2-5.5-13-11.9-25.6-19.3-37.8,0,0,0,0,0,0l43.2-43.9c8.4-8.6,8.3-22.4-.2-30.9l-63.1-62.2-13.4-13.2c-8.6-8.4-22.4-8.3-30.9.2l-12.8,13-31.2,31.7c-22.5-12.8-46.3-22.4-70.8-28.8h0s0-2.9,0-2.9l-.5-62c0-12-10-21.8-22-21.7l-107.3.8c-12,0-21.8,10-21.7,22l.5,60.9v2.7c-26.1,6.8-51.5,17.1-75.3,31.1l-34.4-33.8-9.2-9.1c-13.1-12.9-34.3-12.7-47.2.3l-8.6,8.8-31.3,31.8-19.2,19.5c-12.9,13.1-12.7,34.3.3,47.2l42.9,42.3c-11.3,19.3-20.2,39.5-26.8,60.3h0c-8.2-2.7-17.7-.9-24.2,5.7-2.7,2.7-4.5,6-5.5,9.4l-30.3.3c-18.4.1-33.3,15.2-33.1,33.6l.6,84.3c.1,18.4,15.3,33.3,33.6,33.1l55.1-.4c6.3,24,15.6,47.3,28.1,69.5h0c-3.8,6-4.5,13.2-2.4,19.7l-28.4,28.9c-12.9,13.1-12.8,34.3.3,47.2l52.4,51.6,7.7,7.5c13.1,12.9,34.3,12.7,47.2-.3l7.1-7.2,31.9-32.3s0,0,0,0c18.7,10.3,38.1,18.5,58.1,24.4,5,1.5,10,2.9,15,4.1v3.8s.5,61.6.5,61.6c0,12,10,21.7,22,21.7l107.4-.8c12,0,21.7-10,21.7-22l-.4-60.4v-6.2c25.6-7.1,50.4-17.7,73.8-31.9h0l38.6,38.1,7.9,7.7c8.6,8.4,22.4,8.3,30.9-.2l7.4-7.5,67.9-69c8.4-8.5,8.3-22.4-.2-30.9l-47.3-46.6c11.8-20.6,20.7-42.3,27.1-64.6h2.5s32.4-.3,32.4-.3c18.2-.1,33.1-16.8,33-37.1l-.3-34ZM1101.1,453.1l-.6-72.9c-.1-14.5,11.7-26.5,26.2-26.6l26.6-.3c1.1,3.5,3,6.8,5.8,9.6.9.9,1.9,1.7,3,2.4l-49.1,109.5c-7.1-4.7-11.8-12.6-11.9-21.7ZM1178,479.9h-1.3c0,0-49-.6-49-.6-1.7,0-3.4-.1-5-.5l49.2-109.6c2,.3,4.1.3,6.2.1v110.6ZM1308.4,504.7l2.7,37.4c-1.5.2-2.9.6-4.3,1.1l-62.9-108.9c3-3.9,4.7-8.5,4.9-13.2h36c1,29,8.8,57.7,23.6,83.6ZM1268.4,307.8c1.1,1.1,2.4,2.1,3.7,3l-40.6,87c-1.9-.5-3.8-.8-5.7-.8l-4.5-123.8,41.5,10.7c-2.8,8.2-.9,17.5,5.6,24ZM1279.5,315.9v96.3h-32c-1.1-3.2-2.9-6.1-5.5-8.6-.8-.8-1.6-1.4-2.5-2l40-85.6ZM1237,440.3l62.1,107.5c-.4.3-.8.6-1.1.9-3.4,3.5-5.5,7.8-6.3,12.2l-43.5,1.9c-1.1-2.6-2.7-5.1-4.9-7.2-3.4-3.4-7.6-5.4-12-6.2l-3.8-106.3c3.3-.2,6.6-1.2,9.6-2.9ZM1288.5,377.9v-63.9c4.7-.8,9.2-2.9,12.8-6.6,3.4-3.5,5.5-7.7,6.3-12.2l18.5,4.8c-19.2,23.1-31.8,49.9-37.6,77.9ZM1206.2,244.9c-.3-.3-.5-.5-.6-.8h0s-25.6-25.2-25.6-25.2c-10.4-10.2-10.5-27-.3-37.3l16.2-16.5,1.3-1.3,50,49.3s0,0,0,0l9.6,9.4s0,0,0,0l9.8,9.7,58.9,56.9-18.8-4.8c-1.1-3.5-3-6.9-5.8-9.7-9-8.9-23.4-8.9-32.4-.1l-43.6-11.2-18.8-18.3ZM1189.3,481.2v-116.3c.9-.7,1.9-1.5,2.7-2.3,8.3-8.3,8.8-21.3,1.8-30.4,4.8-15.9,11.2-31.2,18.9-46.2l4.1,112.5c-2.8,1.2-5.4,2.9-7.7,5.2-9,9.1-8.9,23.9.2,32.9,2.6,2.6,5.7,4.3,9,5.4l3.9,107.5c-2,.4-4,1.1-5.8,2-12.3-22.4-21.3-46.1-27.1-70.4ZM1190.2,614l22.9-23.2c2.6,1.9,5.4,3.3,8.4,4,0,0,.1,0,.2,0,1.3.3,2.7.5,4,.6.6,0,1.2,0,1.7,0,1.1,0,2.2-.1,3.3-.3h0c1,0,2-.3,3.1-.7,6.6-2.1,9.7-6.3,12.7-9.5,2.6-4,3.8-8.6,3.7-13.2l41.6-1.8c.9,4.3,3,8.4,6.4,11.7,1.7,1.7,3.6,2.9,5.6,3.9l-13.7,42.4c-6.8-.7-13.9,1.4-19,6.7-2.1,2.2-3.7,4.7-4.8,7.3l-83.4-7.1c-.6-7.4,1.8-15.1,7.4-20.8ZM1248.7,707.1c-2.3-1.2-4.4-2.7-6.3-4.5l-52-51.2c-2.2-2.2-3.9-4.7-5.2-7.3l79.1,6.8c0,6.1,2.2,12.1,6.9,16.7,1.5,1.4,3.1,2.6,4.8,3.5l-12.6,38.9c-5,.5-10.2-.5-14.7-2.9ZM1313.6,669.3l-33.8,33c-1.8,1.8-3.7,3.2-5.8,4.4l10.6-32.8c7,.9,14.3-1.3,19.6-6.7,9-9.1,8.9-23.9-.2-32.9-1.6-1.6-3.4-2.8-5.3-3.8l13.8-42.5c.7,0,1.3.2,2,.2l5.4,75.5c-1.8,1.7-3.9,3.5-6.3,5.5h0ZM1386,687.7c-.6-.2-1.1-.3-1.6-.5-17.4-5.2-34.5-12.2-50.9-20.8l62.7-19.7-10.2,41ZM1398.8,636.6l-70.3,22.1-5.2-72c2.9-1.2,5.5-2.9,7.8-5.2,9-9.1,8.9-23.9-.2-32.9-3.1-3-6.8-5-10.8-5.9l-1.6-22c5.9,8.2,12.5,16,20,23.4,20.9,20.6,45.6,35.1,71.7,43.4l.8.3-12.3,49Z" />
+</svg>
\ No newline at end of file