FastGPT / README.md
jacktol's picture
deploy at 2024-09-16 03:29:08.060634
9e24897 verified
---
title: FastGPT
emoji: 💬
colorFrom: yellow
colorTo: purple
sdk: docker
app_file: main.py
pinned: false
---
# FastGPT: A Lightweight ChatGPT Implementation Using FastHTML
**FastGPT** is a minimalistic ChatGPT implementation built using FastHTML, designed to be fast and lightweight, while providing a seamless experience for users. It connects to the GPT-4o model and supports session-based memory to allow for back-and-forth interactions.
We aim to progressively and iteratively add features to better align with the current state of ChatGPT. This project is open-source, so feel free to contribute by submitting a pull request or forking the repo and building upon it yourself!
**Created by Jack Tol**
[https://jacktol.net](https://jacktol.net)
[https://conversationai.io](https://conversationai.io)
## Video Demo
Watch the demo of FastGPT on YouTube:
[![FastGPT Demo](https://img.youtube.com/vi/24aGmm_0mTw/0.jpg)](https://www.youtube.com/watch?v=24aGmm_0mTw)
## Features
- **GPT-4o Model Integration**: Connects to the latest version of OpenAI's GPT-4o model for advanced text-based interactions.
- **Session-Based Memory**: Keeps track of the current conversation, allowing for coherent back-and-forth dialogue.
- **Session Management**: Refreshing the page or pressing the "New Chat" button will terminate the current session and initiate a fresh one.
- **Automatic Markdown Parsing**: Both the home page and model responses support Markdown, allowing for easy formatting and enhanced readability.
- **Dynamic Input Box**: The chat input dynamically grows for better visibility when entering long messages.
- **Lightweight Design**: Built without front-end frameworks, leveraging vanilla CSS for a lightweight, fast user experience.
- **Token-by-Token Streaming**: Responses from the model stream onto the screen in real-time, providing instant feedback.
- **Interaction Management**: Users cannot send a message while the model is still generating a response, ensuring a smooth interaction.
- **"New Chat" Button**: Easily initiate a new session with a simple button click.
## Usage Instructions
1. **Clone the Repo**
```
git clone https://github.com/jack-tol/fastgpt.git
```
2. **Set your OpenAI API Key**
Ensure your `OPENAI_API_KEY` environment variable is set to your OpenAI API Key.
```
export OPENAI_API_KEY=your-openai-api-key-here
```
3. **Install Dependencies**
Navigate into the cloned directory and install the required dependencies.
```
pip install -r requirements.txt
```
4. **Run the Application**
Open up your terminal, `cd` into the directory where the `main.py` file is located, and run the following command:
```
uvicorn main:app --port 8080 --reload
```
5. **Start Chatting**
Open your browser and navigate to `http://localhost:8080` to start your local ChatGPT experience!
## Contributing
Feel free to contribute to FastGPT by submitting a pull request or creating a fork of the repository. As the project evolves, more features will be added to better align with the capabilities of the ChatGPT platform. Help us make FastGPT even better!