docs(readme): New logo & Readme(s) revamp

README.md

@@ -1,32 +1,38 @@
 <p align="center">
 <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="img/rig_logo_dark.svg">
-    <source media="(prefers-color-scheme: light)" srcset="img/rig_logo.svg">
-    <img src="img/rig_logo.svg" style="width: 40%; height: 40%;" alt="Rig logo">
+    <source media="(prefers-color-scheme: dark)" srcset="img/rig-playgrounds-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="img/rig-playgrounds-light.svg">
+    <img src="img/rig-playgrounds-light.svg" style="width: 40%; height: 40%;" alt="Rig logo">
 </picture>
 <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://crates.io/crates/rig-core"><img src="https://img.shields.io/crates/d/rig-core?color=orange" /></a>
+&nbsp;
 <a href="https://discord.gg/playgrounds"><img src="https://img.shields.io/discord/511303648119226382?color=%236d82cc&label=Discord&logo=discord&logoColor=white" /></a>
 &nbsp;
+<a href="https://github.com/0xPlaygrounds/rig"><img src="https://img.shields.io/github/stars/0xPlaygrounds/rig?style=social" alt="stars - rig" /></a>
+<br>
 <a href=""><img src="https://img.shields.io/badge/built_with-Rust-dca282.svg?logo=rust" /></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/0xPlaygrounds/rig?tab=MIT-1-ov-file"><img src="https://img.shields.io/badge/license-MIT-00bfff.svg?color=red" /></a>
+<a href="https://twitter.com/Playgrounds0x"><img src="https://img.shields.io/twitter/follow/Playgrounds0x"></a>
+<a href="https://docs.rs/rig-core/latest/rig/"><img src="https://img.shields.io/badge/📖documentation-docs.rs-dca282.svg" /></a>
+<br>
 </p>
 &nbsp;
 
+✨ If you would like to help spread the word about Rig, please consider starring the repo!
+
 > [!WARNING]
 > Here be dragons! Rig is **alpha** software and **will** contain breaking changes as it evolves. We'll annotate them and highlight migration paths as we encounter them.
 
 
 ## What is Rig?
-Rig is a Rust library for building scalable, modular, and ergonomic LLM-powered applications.
+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/).
 
-We'd love your feedback. Please take a moment to let us know what you think using this [Feedback form](https://bit.ly/Rig-Feeback-Form).
+Help us improve Rig by contributing to our [Feedback form](https://bit.ly/Rig-Feeback-Form).
 
 ## Table of contents
 
@@ -42,12 +48,14 @@ We'd love your feedback. Please take a moment to let us know what you think usin
 - Simple but powerful common abstractions over LLM providers (e.g. OpenAI, Cohere) and vector stores (e.g. MongoDB, in-memory)
 - Integrate LLMs in your app with minimal boilerplate
 
-## Installation
+
+
+## Get Started
 ```bash
 cargo add rig-core
 ```
 
-## Simple example:
+### Simple example:
 ```rust
 use rig::{completion::Prompt, providers::openai};
 
@@ -57,7 +65,7 @@ async fn main() {
     // This requires the `OPENAI_API_KEY` environment variable to be set.
     let openai_client = openai::Client::from_env();
 
-    let gpt4 = openai_client.model("gpt-4").build();
+    let gpt4 = openai_client.agent("gpt-4").build();
 
     // Prompt the model and print its response
     let response = gpt4
@@ -71,14 +79,24 @@ async fn main() {
 Note using `#[tokio::main]` requires you enable tokio's `macros` and `rt-multi-thread` features
 or just `full` to enable all features (`cargo add tokio --features macros,rt-multi-thread`).
 
+You can find more examples each crate's `examples` (ie. [`src/examples`](./src/examples)) directory. More detailed use cases walkthroughs are regularly published on our [Dev.to Blog](https://dev.to/0thtachi).
+
 ## Integrations
-Rig supports the following LLM providers natively:
-- OpenAI
-- Cohere
-- Anthropic
-- Perplexity
-- Google Gemini
-
-Additionally, Rig currently has the following integration sub-libraries:
-- MongoDB vector store: `rig-mongodb`
-- LanceDB vector store: `rig-lancedb`
+
+| Model Providers | Vector Stores |
+|:--------------:|:-------------:|
+| <br><img src="https://upload.wikimedia.org/wikipedia/commons/thumb/0/04/ChatGPT_logo.svg/1024px-ChatGPT_logo.svg.png" alt="ChatGPT logo" width="50em"> <picture><source media="(prefers-color-scheme: dark)" srcset="https://www.fahimai.com/wp-content/uploads/2024/06/Untitled-design-7.png"><source media="(prefers-color-scheme: light)" srcset="https://upload.wikimedia.org/wikipedia/commons/thumb/4/47/Claude_Ai.svg/1024px-Claude_Ai.svg.png"><img src="https://www.fahimai.com/wp-content/uploads/2024/06/Untitled-design-7.png" alt="Claude Anthropic logo" width="50em"></picture> <br> <img src="https://cdn.sanity.io/images/rjtqmwfu/production/0adbf394439f4cd0ab8b5b3b6fe1da10c8099024-201x200.svg" alt="Cohere logo" width="50em"> <img src="https://logospng.org/download/google-gemini/google-gemini-1024.png" style="background-color: white; border-radius: 10px; padding: 5px 5px ; width: 3em;" alt="Gemini logo"> |  <br><img src="https://cdn.prod.website-files.com/6640cd28f51f13175e577c05/664e00a400e23f104ed2b6cd_3b3dd6e8-8a73-5879-84a9-a42d5b910c74.svg" alt="Mongo DB logo" width="50em"> <img src="https://upload.wikimedia.org/wikipedia/commons/e/e5/Neo4j-logo_color.png" alt="Neo4j logo" style="background-color: white; border-radius: 1em; padding: 1em 1em ; width: 4em;"><br><br><img src="https://cdn-images-1.medium.com/max/844/1*Jp6VwF0OcdeyRyW0Ln0RMQ@2x.png" width="100em" alt="Lance DB logo"> |
+
+
+Vector stores are available as separate companion-crates:
+- MongoDB vector store: [`rig-mongodb`](https://github.com/0xPlaygrounds/rig/tree/main/rig-mongodb)
+- LanceDB vector store: [`rig-lancedb`](https://github.com/0xPlaygrounds/rig/tree/main/rig-lancedb)
+- Neo4j vector store: [`rig-neo4j`](https://github.com/0xPlaygrounds/rig/tree/main/rig-neo4j)
+- Qdrant vector store: [`rig-qdrant`](https://github.com/0xPlaygrounds/rig/tree/main/rig-qdrant)
+
+
+<p align="center">
+<br>
+<br>
+<img src="img/built-by-playgrounds.svg" alt="Build by Playgrounds" width="30%">
+</p>

rig-lancedb/README.md

@@ -1,2 +1,32 @@
-# Rig-lancedb
-Vector store index integration for LanceDB
+<!-- <div style="display: flex; align-items: center; justify-content: center;">
+    <picture>
+        <source media="(prefers-color-scheme: dark)" srcset="../img/rig_logo_dark.svg">
+        <source media="(prefers-color-scheme: light)" srcset="../img/rig_logo.svg">
+        <img src="../img/rig_logo.svg" width="200" alt="Rig logo">
+    </picture>
+    <span style="font-size: 48px; margin: 0 20px; font-weight: regular; font-family: Open Sans, sans-serif;"> + </span>
+    <picture>
+        <source media="(prefers-color-scheme: dark)" srcset="https://companieslogo.com/img/orig/MDB_BIG.D-96d632a9.png?t=1720244492">
+        <source media="(prefers-color-scheme: light)" srcset="https://cdn.iconscout.com/icon/free/png-256/free-mongodb-logo-icon-download-in-svg-png-gif-file-formats--wordmark-programming-langugae-freebies-pack-logos-icons-1175140.png?f=webp&w=256">
+        <img src="https://cdn.iconscout.com/icon/free/png-256/free-mongodb-logo-icon-download-in-svg-png-gif-file-formats--wordmark-programming-langugae-freebies-pack-logos-icons-1175140.png?f=webp&w=256" width="200" alt="MongoDB logo">
+    </picture>
+</div>
+
+<br><br> -->
+
+## Rig-Lancedb
+This companion crate implements a Rig vector store based on Lancedb.
+
+## Usage
+
+Add the companion crate to your `Cargo.toml`, along with the rig-core crate:
+
+```toml
+[dependencies]
+rig-lancedb = "0.1.0"
+rig-core = "0.4.0"
+```
+
+You can also run `cargo add rig-lancedb rig-core` to add the most recent versions of the dependencies to your project.
+
+See the [`/examples`](./examples) folder for usage examples.

rig-mongodb/README.md

@@ -1,6 +1,6 @@
 
 
-<div style="display: flex; align-items: center; justify-content: center;">\
+<div style="display: flex; align-items: center; justify-content: center;">
     <picture>
         <source media="(prefers-color-scheme: dark)" srcset="../img/rig_logo_dark.svg">
         <source media="(prefers-color-scheme: light)" srcset="../img/rig_logo.svg">
@@ -25,10 +25,10 @@ Add the companion crate to your `Cargo.toml`, along with the rig-core crate:
 
 ```toml
 [dependencies]
-rig-mongodb = "0.1.2"
-rig-core = "0.2.1"
+rig-mongodb = "0.1.3"
+rig-core = "0.4.0"
 ```
 
 You can also run `cargo add rig-mongodb rig-core` to add the most recent versions of the dependencies to your project.
 
-See the [examples](./examples) folder for usage examples.
+See the [`/examples`](./examples) folder for usage examples.