PrivGPT Studio

Your private AI studio — versatile, secure, and all‑in‑one.

🔗 Quick Links

• 🚀 Demo
• 💡 Why It’s Needed
• 📦 Features
• 🛠 Tech Stack
• 🖥️ Getting Started
• 📂 Project Structure
• 🤝 Contributing
• 📜 Code of Conduct
• 💬 Support
• 🌟 Project Admin and Mentors
• 🙌 Project Contributors
• ⚖ License

🎥 Demo

PrivGPT_Studio_Demo.mp4

⬆️

💡 Why It’s Needed

AI tools are everywhere — but most send your data to cloud servers you can’t control.
Startups, researchers, and creators need AI that’s private, flexible, and powerful.

👉 PrivGPT Studio solves this by combining local and cloud models in one workspace, with:
✅ Full privacy control (no hidden history sharing)
✅ Versatile input (text, PDF, images, voice)
✅ Offline fallback, multi‑chat management, latency tracking

AI without compromise.

⬆️

📦 Features

🧠 Multi‑chat with cross‑references
🔒 Privacy‑first design (local/cloud separation)
📄 PDF summarization
📊 image/graph interpretation
🎤 voice input
✨ Rename, export, delete sessions
⚡ Offline fallback to local models
📈 Latency count and metrics

⬆️

🛠 Tech Stack

Frontend: Next.js (React), TailwindCSS
Backend: Flask (Python)
Database: MongoDB
AI:
   ● Local: Ollama models
   ● Cloud: Gemini API

⬆️

🖥️ Getting Started

Before you begin, make sure you have the following installed on your system:

• Git
• Node.js (v18+ recommended)
• Python (3.9 or above)
• pip (Python package manager)
• (Optional) Ollama installed locally if you want to use local models.

1. Fork this repository.

2. Clone the repository

git clone https://github.com/<your-github-username>/PrivGPT-Studio.git
cd PrivGPT-Studio

3. Set up the client (Next.js frontend)

cd client

npm ci
# If you face a dependency conflict (ERESOLVE error), try:
# npm install --legacy-peer-deps
# If that doesn't work either, try:
# npm install

copy .env.example .env 
# (For linux) cp .env.example .env
# To learn how to obtain the variables required in '.env',
# please see 'docs/env-setup-guide.md'.

npm run dev
# Runs on http://localhost:3000

4. Set up the server (Flask backend)

cd server

python -m venv venv 
venv\Scripts\activate 
# For (Linux/Mac) source venv/bin/activate

pip install -r requirements.txt

copy .env.example .env 
# (For linux) cp .env.example .env
# To learn how to obtain the variables required in '.env',
# please see 'docs/env-setup-guide.md'.

python app.py
# Runs on http://localhost:5000

5. (Optional) Start Ollama locally

ollama serve
ollama pull <model_name>

⬆️

📂 Project Structure

privgpt-studio/
│
├── .github/
│   ├── ISSUE_TEMPLATE/
│   ├── CODE_OF_CONDUCT.md
│   └── ...
│
├── assets/
│
├── client/          # Next.js frontend
│   ├── app/
│   ├── components/
│   └── ...
│
├── docs/            
│   └── env-setup-guide.md
│   
├── server/          # Flask backend
│   ├── app.py
│   ├── requirements.txt
│   └── ...
│
├── LICENSE           
└── README.md

⬆️

🤝 Contributing

Contributions are welcome! 🎉
Please check our Contributing Guidelines to learn about:

• Our development process
• How to propose bug fixes and improvements
• Coding standards and PR workflow

⬆️

📜 Code of Conduct

We are committed to creating a welcoming and inclusive environment for everyone. Please be respectful, inclusive, and considerate in all interactions.

By participating in this project, you agree to follow our Code of Conduct.

If you witness or experience unacceptable behavior, please report it privately via [email protected].

⬆️

💬 Support

If you have other questions, need help, or want to start a discussion about PrivGPT Studio,
please join our Discord Server.
💡 We’d love to hear your ideas, feedback, and suggestions there!

⬆️

🌟 Project Admin and Mentors

Project Admin - Rucha Ambaliya

⬆️

🙌 Project Contributors

⬆️

⚖ License

This project is licensed under the PolyForm Noncommercial License 1.0.0. Make sure to review and comply with the license terms.

✔️ You may use, modify, and share the code only for non‑commercial purposes.
✔️ You must include the following attribution in any copies or derivative works:
Required Notice: Copyright 2025 Rucha Ambaliya (https://github.com/rucha-ambaliya/privgpt-studio)
🚫 Commercial use requires separate permission from the author.

See the LICENSE file for more details.

⬆️