RustGPT π¦β¨
RustGPT.Blog.Post.mp4
Welcome to the RustGPT repository! Here, you'll find a web ChatGPT clone entirely crafted using Rust and HTMX, where technology meets simplicity and performance. π
Introduction
RustGPT is my latest experiment in cloning the abilities of OpenAI's ChatGPT. It represents the fourth iteration in a series of clones, each built with different tech stacks to evaluate their functionality in creating a ChatGPT-like application.
In this repository, you will find a Rust-based server leveraging the Axum framework combined with HTMX, providing a Rusty web development experience. From database operations to streaming responses, this project covers a broad spectrum of backend functionalities and real-time web interactions.
So, for Rust enthusiasts and web developers alike, dive in to explore a world where web development is redefined with the power of Rust!
Features π
- Rust with Axum Framework: A fast and reliable server that's all about performance and simplicity.
- SQLite: A lightweight yet powerful database for all your data persistence needs.
- Server Sent Events (SSE): Real-time streaming made easy to bring life to the ChatGPT interactions.
- HTMX: No hefty JavaScript frameworks neededβHTMX keeps interactions snappy with simple HTML attributes.
Tech Stack π οΈ
sqlx
: Direct and type-safe SQL queries and migrations.tera
: A templating engine inspired by Jinja2, for rendering the HTML views.axum
: A web application framework that's easy to use and incredibly fast.
For those eyeing some client-side WASM magic, you might also want to check out Yew or Leptos for more complex applications.
Quickstart π
Jump right into it by following these steps:
- Clone the repository.
- Create a .env
MIGRATIONS_PATH=db/migrations
TEMPLATES_PATH=templates
DATABASE_URL=sqlite:db/db.db
DATABASE_PATH=db/db.db
OPENAI_API_KEY=<api-key> (only necessary for tests, users will add their own keys)
- Install TailwindCSS Standalone in this repository: https://tailwindcss.com/blog/standalone-cli.
cargo install just
: install Justjust init
: install additional tools and migrate the dbjust dev
: concurrently run tailwind and cargo run in watch mode- Open your browser and enjoy chatting with your Rust-powered ChatGPT clone (port 3000 by default)
Contributing π€
Contributions are what make the open-source community an incredible place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make RustGPT better, please fork the repo and create a pull request. You can also simply open an issue. Don't forget to give the project a star! Thank you again!
Acknowledgments π
Hats off to the wonderful crates and libraries that made RustGPT possible!
Created with π by a Rustacean who believes in the power of Rust for the web! Follow the journey on Bitswired.