MindSpace is a comprehensive, AI-powered productivity and learning platform designed to enhance study and work workflows. It combines intelligent chat, automated flashcard generation, quiz creation, and audio synthesis within a fully containerized environment.
Intelligent workspace for all your learning needs.
Interactive Chat Interface.
Working Mechanism.
- Intelligent Chat: Interactive interface with RAG capabilities via pgvector for context-aware conversations.
- Study Tools: Automated flashcard, report, and quiz generation powered by Google Gemini.
- Content Management: Robust document analysis via Apache Tika and structured report generation.
- Audio Features: Integrated text-to-speech and audio processing for hands-free learning.
- Secure Authentication: JWT-protected registration and login system ensuring data privacy.
- Language: Java 21
- Framework: Spring Boot
- Database: PostgreSQL with pgvector extension
- Security: Spring Security with JWT
- Build Tool: Maven (containerized)
- Framework: React 19 (Vite 7)
- Language: TypeScript
- Styling: Tailwind CSS 4
- State Management: Zustand
The application is fully containerized. To run the project, you only need:
- Podman (preferred) or Docker
- podman-compose or docker-compose
Create a .env file in the project root directory to manage your credentials and secrets. This file is required for the containers to initialize correctly.
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_password
GEMINI_API_KEY=your_google_gemini_api_key
JWT_SECRET_KEY=your_secure_jwt_secret- Build and Start the Application Run the following command from the project root to build the images and start all services (Database, Backend, and Frontend):
podman-compose up --build -d - Access the Application Once the containers are healthy:
- Frontend UI: http://localhost:8081
- Backend API: http://localhost:8080
- Database: localhost:5435 (External access)
MindSpace/
├── backend/ # Spring Boot application & Dockerfile
├── frontend/ # React application & Dockerfile
├── docker-compose.yml # Container orchestration
└── .env # Environment variables
MIT