📚 Reading Room - Intelligent Book Social Platform

A next-generation book-centered social media platform that combines AI-powered recommendations, intelligent book discussions, and vibrant community features to revolutionize how readers discover, discuss, and share their literary experiences.

🌟 Key Features

📖 Smart Book Discovery

Google Books Integration: Seamlessly search and explore millions of books
AI-Powered Recommendations: Advanced semantic search based on emotional tone, genre preferences, and reading patterns
Personalized Discovery: Machine learning algorithms that understand your reading taste
Visual Book Search: Rich metadata with covers, descriptions, and ratings

🤖 RAG-Based Book Chat

Intelligent Book Discussions: Chat with AI about specific books using Retrieval-Augmented Generation
Context-Aware Responses: AI understands book content through vector embeddings and Wikipedia integration
Literary Analysis: Deep conversations about themes, characters, plot, and literary techniques
Memory-Enabled Conversations: Maintains conversation history for continuity

🎯 Semantic Recommendation Engine

Emotion-Based Filtering: Find books by mood (Happy, Suspenseful, Sad, Surprising, Angry)
Genre Intelligence: Advanced categorization beyond simple genre tags
Vector Search: Semantic similarity matching for nuanced recommendations
Multi-Factor Analysis: Combines content analysis, sentiment, and user preferences

👥 Social Community Platform

Dynamic Posts: Share thoughts, reviews, and reading updates
Rich Discussions: Comment threads and book-focused conversations
User Profiles: Track reading history, favorite books, and social connections
Feed Algorithms: Curated content based on interests and connections

🏗 Architecture Overview

Frontend (Next.js 15 + TypeScript)

Frontend/
├── app/                    # Next.js 15 App Router
│   ├── auth/              # Authentication pages
│   ├── books/             # Book discovery & details
│   ├── posts/             # Social media feed
│   ├── discussions/       # Book chat interface
│   ├── ai-recommendations/ # AI recommendation engine
│   ├── discover/          # Book search & browse
│   └── profile/           # User management
├── components/            # Reusable UI components
│   ├── ui/               # shadcn/ui component library
│   ├── book-card.tsx     # Book display components
│   ├── post-card.tsx     # Social post components
│   └── chat-interface.tsx # AI chat components
└── lib/                  # Utilities & API clients
    ├── api-client.ts     # Backend API integration
    ├── auth-context.tsx  # Authentication state
    └── hooks/            # Custom React hooks

Backend (Django REST Framework)

Backend/
├── readingroom/          # Main Django project
│   ├── settings.py      # Configuration with CORS, JWT
│   └── urls.py          # API routing
├── books/               # Book management
│   ├── models.py        # Book & UserBookStatus models
│   ├── views.py         # Google Books API integration
│   ├── serializers.py   # API serialization
│   └── utils/           # Google Books utilities
├── posts/               # Social media functionality
│   ├── models.py        # Post & interaction models
│   ├── views.py         # CRUD operations
│   └── serializers.py   # Post API serialization
├── users/               # User management
│   ├── models.py        # Custom User model
│   ├── views.py         # Authentication & profiles
│   └── serializers.py   # User API serialization
└── comments/            # Comment system
    ├── models.py        # Comment models
    ├── views.py         # Comment operations
    └── serializers.py   # Comment serialization

RAG Chat System (FastAPI + AI)

Retrieval-Augmented Conversational Agents/
├── backend/
│   ├── api.py           # FastAPI endpoints
│   ├── embedder.py      # Vector embedding generation
│   ├── query_engine.py  # RAG query processing
│   ├── wiki_fetch.py    # Wikipedia data retrieval
│   └── main.py          # FastAPI application
├── vectorstore/         # ChromaDB vector storage
└── data/               # Book metadata & content

Semantic Recommender (ML Engine)

Semantic-book-recommender/
├── app.py              # Gradio recommendation interface
├── vector-search.ipynb # Vector similarity algorithms
├── sentiment-analysis.ipynb # Emotion classification
├── text-classification.ipynb # Genre categorization
└── data/               # Processed book datasets

🚀 Technology Stack

Frontend Technologies

Next.js 15: React framework with App Router
TypeScript: Type-safe development
Tailwind CSS: Utility-first styling
shadcn/ui: Modern component library
Radix UI: Accessible component primitives
Axios: HTTP client for API communication
NextAuth.js: Authentication solution

Backend Technologies

Django 5.2: Robust web framework
Django REST Framework: API development
PostgreSQL: Production database
JWT Authentication: Secure token-based auth
Django CORS Headers: Cross-origin support
Google Books API: Book metadata source

AI & ML Technologies

FastAPI: High-performance API framework
ChromaDB: Vector database for embeddings
Sentence Transformers: Text embedding models
Google Gemini API: Large language model
LangChain: LLM application framework
Gradio: ML model interface
Pandas & NumPy: Data processing

Development & Deployment

Docker: Containerization
Git: Version control
Environment Variables: Secure configuration
CORS: Cross-origin resource sharing
RESTful APIs: Standardized communication

🔧 Installation & Setup

Prerequisites

Node.js 18+ and npm/pnpm
Python 3.10+ and pip
PostgreSQL (for production)
Git for version control

API Keys Required

# Google Books API
GOOGLE_API_KEY=your_google_books_api_key

# Google Gemini API (for AI chat)
GEMINI_API_KEY=your_gemini_api_key

# Django Secret Key
SECRET_KEY=your_django_secret_key

# Database URL (production)
DATABASE_URL=your_postgresql_url

Quick Start

1. Frontend Setup

cd Frontend
npm install
# or
pnpm install

# Start development server
npm run dev
# Runs on http://localhost:3000

2. Django Backend Setup

cd Backend
pip install -r requirements.txt

# Database migrations
python manage.py migrate

# Create superuser (optional)
python manage.py createsuperuser

# Start Django server
python manage.py runserver
# Runs on http://localhost:8000

3. RAG Chat System Setup

cd "Retrieval-Augmented Conversational Agents for Literary Discussion/backend"
pip install -r requirements.txt

# Create .env file with API keys
echo "GOOGLE_API_KEY=your_key" > .env
echo "GEMINI_API_KEY=your_key" >> .env

# Start FastAPI server
uvicorn main:app --reload --port 8001
# Runs on http://localhost:8001

4. Semantic Recommender Setup

cd Semantic-book-recommender
pip install -r requirements.txt

# Start Gradio interface
python app.py
# Creates shareable Gradio endpoint

📊 API Documentation

Django Backend APIs

Base URL: http://localhost:8000/api/
Authentication: JWT Bearer tokens
Documentation: Available at /api/docs/ (when DEBUG=True)

Key Endpoints

# Authentication
POST /auth/login/          # User login
POST /auth/register/       # User registration
POST /auth/refresh/        # Token refresh

# Books
GET  /books/              # List books
GET  /books/{id}/         # Book details
POST /books/fetch/        # Fetch from Google Books
GET  /books/search/       # Search books

# Posts
GET  /posts/              # List posts
POST /posts/              # Create post
GET  /posts/{id}/         # Post details
PUT  /posts/{id}/         # Update post
DELETE /posts/{id}/       # Delete post

# Comments
GET  /posts/{id}/comments/ # Post comments
POST /posts/{id}/comments/ # Add comment

RAG Chat APIs

Base URL: http://localhost:8001/
Content-Type: application/json

# Book Preparation
GET  /search-books        # Search Google Books
POST /books/fetch-wiki    # Fetch Wikipedia data
POST /books/embed         # Generate embeddings
POST /books/prepare       # Full preparation pipeline

# Chat Interface
POST /chat/query          # Ask questions about books
GET  /books/check         # Check if book is ready

Semantic Recommender

Interface: Gradio web interface
Input: Text description, genre, emotional tone
Output: Ranked book recommendations with covers

🔥 Core Features Deep Dive

1. AI-Powered Book Recommendations

The semantic recommendation system uses advanced machine learning to understand book content and user preferences:

Vector Embeddings: Books are represented as high-dimensional vectors
Semantic Search: Find books similar in meaning, not just keywords
Emotion Analysis: Filter by emotional tone (joy, fear, anger, surprise, sadness)
Genre Intelligence: Advanced categorization beyond simple tags
Personalization: Learns from user interactions and preferences

2. RAG-Based Book Discussions

Revolutionary AI chat system for deep book conversations:

Content Preparation: Wikipedia data + vector embeddings
Context Retrieval: Relevant book passages for each question
Response Generation: Google Gemini creates contextual answers
Memory: Maintains conversation history for continuity
Metadata Integration: Uses book details for richer responses

3. Social Media Features

Community-focused platform for book lovers:

Dynamic Posts: Rich text posts about books and reading
Comments & Discussions: Threaded conversations
User Profiles: Reading history and social connections
Book Status: Track reading progress (want to read, reading, read)
Discovery Feed: Algorithm-curated content

4. Book Discovery Engine

Powerful search and discovery tools:

Google Books Integration: Access to millions of books
Advanced Filtering: Genre, author, publication date, ratings
Visual Search: Rich metadata with covers and descriptions
Related Books: AI-suggested similar titles
Trending: Popular books and rising titles

🔒 Security & Authentication

JWT Tokens: Secure authentication with refresh mechanism
CORS Configuration: Proper cross-origin resource sharing
Environment Variables: Secure API key management
Input Validation: Request validation and sanitization
Rate Limiting: API protection against abuse
HTTPS Ready: SSL/TLS support for production

🚀 Deployment

Development

Frontend: Next.js development server
Backend: Django development server
Database: SQLite for development
AI Services: Local FastAPI instances

Production

Frontend: Vercel, Netlify, or custom hosting
Backend: Railway, Heroku, or VPS
Database: PostgreSQL (Railway, Supabase, AWS RDS)
AI Services: Cloud deployment with Docker
CDN: Static asset optimization

🤝 Contributing

We welcome contributions! Please see our contributing guidelines:

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit changes: git commit -m 'Add amazing feature'
Push to branch: git push origin feature/amazing-feature
Open a Pull Request

Development Guidelines

Follow TypeScript/Python best practices
Write comprehensive tests
Update documentation
Follow conventional commit messages
Ensure code passes linting

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Google Books API for book metadata
Google Gemini for AI conversation capabilities
ChromaDB for vector storage and retrieval
shadcn/ui for beautiful UI components
Vercel for Next.js hosting platform
Open Source Community for amazing tools and libraries

📧 Contact & Support

Issues: GitHub Issues
Discussions: GitHub Discussions

Reading Room - Where every page opens a new conversation 📚✨

Name		Name	Last commit message	Last commit date
Latest commit History 35 Commits
Backend		Backend
Frontend		Frontend
Retrieval-Augmented Conversational Agents for Literary Discussion		Retrieval-Augmented Conversational Agents for Literary Discussion
Semantic-book-recommender		Semantic-book-recommender
.DS_Store		.DS_Store
.gitignore		.gitignore
README.md		README.md
REGISTRATION_FIX_SUMMARY.md		REGISTRATION_FIX_SUMMARY.md
package-lock.json		package-lock.json

scopophobic/Readingroom

Folders and files

Latest commit

History

Repository files navigation