This is a personal project to create a multi-user system that interacts with openAI api (for now) to mimic the experience of the chatgpt website, with lower cost and pay as you go plan tho.
This is a multi-user backend application where users can log in, view and manage conversations, and interact with language models! The frontend is built using Streamlit, and the backend is powered by Flask with a PostgreSQL database. Plus, we’ve got Alembic in the mix to handle all your database migrations. 🧙♂️
- Backend: Flask 🧪
- Frontend: Streamlit 🌐
- Database: PostgreSQL 🐘
- ORM & Migrations: SQLAlchemy & Alembic 🛠️
- Containerization: Docker 🐳
- AI Platform: OpenAI 🧠
- 👥 Multi-user login/register system
- 💬 Manage conversations with ease
- 📜 View conversation threads and interact in real-time
- 🔑 Token-based authentication (cookies, yum! 🍪)
- 🐳 Dockerized environment for smooth sailing 🚢
- 💾 PostgreSQL integration for all your database needs
- 🔄 Database migrations made easy with Alembic
- +1 Cool factor 😎
Follow these steps to set up and run the project on your local machine:
Make sure you have the following installed:
- Docker 🐳
- Docker Compose 📦
- Git 🌱
- Clone the repository to your local machine:
git clone https://github.com/yourusername/yourproject.git
cd yourproject- Create your .env file. The template is available in
.env.examplefile. - Build the containers and bring the project to life! 🌟
docker-compose up --build- Voila! Your backend is now running on http://localhost:5000 and the frontend on http://localhost:8501. 🎉
- Register/Login: First things first, head to the login/register page (on the frontend) and create an account. No spam emails, we promise! 💌
- View Conversations: After logging in, you can browse through your conversations. Your last one is conveniently opened by default! 📂
- Send New Messages: Need to add something? Send a new message right from the conversation thread! 💬
- Create New Conversations: Start a new conversation with just a click! ✨
Alembic handles the database migrations, so you don’t have to. After setting up the Docker containers, run the following command to apply migrations:
docker exec -it flask-backend alembic upgrade head- For a development environment, use the Dockerfile to spin up both the backend and frontend.
- Ensure the database credentials in your .env file match the ones in the docker-compose.yml.
Contributions are welcome! Feel free to open issues or submit pull requests if you have any feature ideas, improvements, or bug fixes.
- Fork this repository 🍴
- Create a branch for your feature/fix 🏗️
- Commit your changes 💾
- Open a Pull Request 📨