MinimalChat is a minimal and lightweight open-source chat application with full mobile PWA support that allows you to interact with various language models, including GPT-4, Claude Opus, various Local/Custom Model Endpoints. A focus on being simple to setup and use while being fully featured and very responsive is always the top priority.
docker pull tannermiddleton/minimal-chat:latest- Enter the port number to run on and that is it!
Visit the Application Demos Wiki Page for more demos.
general-use-demo.mp4
A huge thank you to the innovative folks at Web LLM for making it possible to bring the magic of large language models (LLMs) directly to your browser!
With this integration, you can now seamlessly download and cache popular LLM models like llama-3-8b-instruct locally and run them entirely within your browser, without any hassle or reliance on external servers. This means you can enjoy greater control and unparalleled flexibility in how you choose to interact with models.
Check Out the Wiki! for more detailed information
To run the web app locally, you'll need NodeJS installed. Then, navigate to the project directory and run the following commands:
- Install needed packages:
npm install - Build the app
npm run build - Start local server:
npm run preview(terminal will output the IP and port the server is running on). Optionally you can runnpm run devto run the application in development mode. - That's it! The app is now running locally.
Visit the Wiki for a detailed explanation of available configuration options.
- Minimal layout
- Supports multiple language models, including:
- GPT Model
- Claude 3 Models
- Open AI Response Formatted APIs (custom/local) models
- Local Browser Loaded Models
- Switch models mid-conversations and maintain context
- Swipe Gestures for quick settings and conversations access
- Edit, Regenerate or Delete past message responses
- Markdown Support
- Code Syntax Highlighting
- Basic DALL-E 3 Integration (Prefix GPT model messages with image:: and then your description to generate images)
- Conversation Importing/Exporting
- Responsive layout for mobile use
- Progressive Web Application Support
Yes, MinimalChat is open-source and free to use. However, you'll need to provide your own API keys for the language models you want to use if they require one. Local models etc..would not require an API key and could be used freely.
Yes! If you use LM Studio to locally host a LLM Model, you can connect and chat with any model that returns a response in the OpenAI Response format standard.
You can even load a full model into your browser directly and run interact with it all within MinimalChat. After the model is initally downloaded and cached the first time it can be used without an internet connection.
Yes, all conversations are stored locally on your device and are not sent to any servers other than the necessary API calls to the language models.
Yes, MinimalChat is designed to be fully mobile compatible. You can even install it as a PWA for a native app-like experience.
- Swipe to the Left on the bottom input box and your Conversations dialog will appear.
- Swipe to the Right on the bottom input box and your Settings dialog will appear.
MinimalChat supports integration with any API endpoint that returns responses formatted according to OpenAI's specifications. This feature allows users to connect with a variety of language models hosted externally, providing flexibility and extending the capabilities of the app.
Get more information in the Open AI API Format Wiki
We welcome contributions from the community! If you'd like to contribute to MinimalChat, please follow these guidelines:
- Submit bug reports and feature requests using the issue tracker.
- For code contributions, fork the repository, make your changes, and submit a pull request.
- Ensure that your code follows the project's coding style and conventions.
- Provide clear and concise commit messages and pull request descriptions.
If you encounter any issues while using MinimalChat, try the following:
- Make sure you have a stable internet connection.
- Verify that your API keys are correct and have the necessary permissions.
- As a LAST STEP Clear your browser cache and reload the app.
- This also clears all of your saved configured settings. You should never really need to do this, but weirder things have happened.
- If the issue persists, please report it using the issue tracker.
MinimalChat is licensed under the MIT License. See LICENSE for more information.
If you have any questions, feedback, or suggestions, feel free to reach out to us:
Thank you for using MinimalChat!
Buy me a coffee for some reason: ☕️ 
