Replichat is an open source LLM chat application (a ChatGPT clone with plans to support more providers later) built with a local-first approach for blazing-fast, instant UIs without loading states.
Live Demo: replichat.antoinechalifour.dev
Replichat leverages a modern local-first approach to deliver an ultra-fast and responsive chat experience. By keeping UI interactions local and synchronizing changes in the background, the app eliminates annoying spinners and loading states while still ensuring data consistency across multiple tabs.
- Instant UI: Fast, local-first user interface that ensures immediate responsiveness.
- Resilient Streaming: Robust content streaming across multiple tabs with resilient synchronization powered by Replicache.
- Multiple Providers: Currently supports OpenAI, with plans to integrate more providers in the future.
- Modern Architecture: Leverages state-of-the-art tools and frameworks to ensure reliability and scalability.
- Tanstack Start: Used for the web framework, authentication, and server functions.
- Replicache: Implements the local-first sync engine.
- Redis Streams: Provides resilient streaming to keep multiple tabs synchronized.
- Postgres: Serves as the primary database for structured data.
- OpenAI (via ai SDK): Used to power the chat responses.
- Coolify: Deployed with Coolify for a simple and robust hosting solution.
Check out the live demo: replichat.antoinechalifour.dev
You can also watch a video demo of the project on Twitter (note that GitHub does not support embedding tweets directly):
View the demo on Twitter: Tweet by Antoine_Chlfr
To run Replichat locally, follow these steps:
-
Clone the repository:
git clone https://github.com/antoinechalifour/replichat cd replichat -
Install dependencies:
pnpm install
-
Create and configure your environment variables:
Create a
.envfile in the root directory and add the necessary configurations (e.g., database URL, OpenAI API keys, etc.). See the provided.env.examplefor guidance. -
Run the development server:
pnpm dev
-
Open in your browser:
Navigate to
http://localhost:3000(or the configured port) to see Replichat in action.
Replichat is designed to be user-friendly. Once running, simply interact with the chat interface, and reap the benefits of its local-first, lightning-fast experience. All UI operations are handled instantly, while the synchronization happens in the background.
Contributions are very welcome! If you'd like to contribute:
- Fork the repository.
- Create a new branch for your feature or bugfix.
- Commit your changes.
- Open a pull request with a description of your changes.
Please make sure to follow the project's coding conventions and include tests where appropriate.
Distributed under the MIT License. See the LICENSE file for more details.
- Thanks to the developers of Tanstack Start, Replicache, and other open source projects that made Replichat possible.
- Hat tip to the community for continuous inspiration and support.
Happy chatting! 🫶
Feel free to customize this README further to suit your project's needs. Enjoy developing Replichat!