📝 Pen2PDF

A comprehensive productivity suite that combines AI-powered document processing, schedule management, task organization, and intelligent note-taking in one unified platform.

Pen2PDF Suite is a modern web application that offers six powerful productivity tools: AI-powered text extraction and PDF conversion, intelligent timetable management with Excel/CSV import, comprehensive todo list management with subtasks, smart notes generation with a searchable library, a full-featured digital whiteboard, and an AI assistant (Bella) for intelligent help - all designed to streamline your academic and professional workflow.

🔗 Links

Demo - See the application in action
Documentation - Complete setup and usage guide
Issues - Report bugs or request features
Contributing - Help improve the project

🚀 Features

📝 Pen2PDF - AI-Powered Document Conversion

🤖 AI-Powered Text Extraction: Uses Google Gemini AI to extract text from various file formats
📝 Multiple File Format Support: PDF, PPT, PPTX, PNG, JPG, WebP
✏️ Real-time Markdown Editor: Edit extracted text with live markdown formatting
📄 Professional PDF Export: Generate high-quality PDFs with custom styling
📤 Markdown Export: Download content as markdown files
🎯 Drag & Drop Interface: Intuitive file upload with drag-and-drop support
📋 Blank Document Mode: Start with a blank document without file upload

📅 Timetable Management

📊 Schedule Organization: Create and manage your daily, weekly schedules
📁 Excel/CSV Import: Import timetable data from CSV, XLSX, and XLS files
🏫 Class Management: Organize subjects, teachers, rooms, and class types (Theory/Lab)
⏰ Time Slot Management: Manage class timings and daily schedules
🔄 Bulk Operations: Import multiple entries at once with validation
🗓️ Weekly View: Visualize your entire week's schedule in an organized format

✅ TodoList - Task Management

📋 Task Organization: Create todo cards with organized task lists
🔗 Subtask Support: Break down complex tasks into manageable subtasks
📌 Priority Pinning: Pin important subtasks for quick access
✓ Progress Tracking: Mark tasks and subtasks as completed
📊 Task Statistics: View completion progress and task analytics
🎯 Focus Mode: Expandable cards to focus on specific task groups

📚 Notes Generation & Library

🤖 Smart Notes Creation: AI-powered generation of study notes from uploaded files
📖 Notes Library: Searchable collection of all your generated notes
📝 Rich Text Support: Create and edit notes with markdown formatting
🔄 Note Regeneration: Retry note generation with improved prompts
💾 Persistent Storage: Save and organize notes in a dedicated library
🎯 Blank Note Creation: Start with empty documents for manual note-taking

🤖 AI Assistant (Bella) - Intelligent Help

💬 Multi-Model Support: Switch between LongCat, Gemini, and GitHub Models
- LongCat-Flash-Chat
- LongCat-Flash-Thinking
- Gemini 2.5 Pro
- Gemini 2.5 Flash
- GitHub Models (new): Access GPT-4o, GPT-4, Claude, and more via GitHub Models API
  - Runtime model discovery with your GitHub PAT
  - Fallback to catalog when discovery unavailable
  - Supports gpt-4o, gpt-4o-mini, claude-3-5-sonnet, claude-4, and more
🧠 Smart Context Window: AI remembers last 20 messages for coherent conversations
📝 Markdown & LaTeX Rendering: Beautiful formatting for code, math equations, and text
📎 File Upload: Upload files for context (vision-capable models only)
- Supports images: PNG, JPEG, WebP, GIF
- Blocked types: .docx, .pdf, .ppt, .pptx, .rtf (no server-side conversion yet)
- Client-side and server-side validation
📚 Notes Context: Load and select notes from your library as context
🔍 Smart Search: Search through notes to find relevant context
💾 Chat Persistence: Conversation history is saved and loaded automatically
🎯 CLI-Style Interface: Clean, terminal-inspired chat interface with syntax highlighting
🔄 Dynamic Model Switching: Seamlessly switch between AI models mid-conversation
⚠️ Rate Limit Handling: Graceful error handling with model switch suggestions

🌐 Universal Features

📱 Responsive Design: Works seamlessly on desktop and mobile devices
⚡ Fast Processing: Efficient processing and data management
🎨 Modern UI: Clean, intuitive interface with consistent design
🔐 Local Storage: Secure data management with MongoDB integration

⚡ Tech Stack

Languages

Frontend Frameworks & Libraries

Backend Frameworks

Databases

AI

Tools & Libraries

DevOps & Development Tools

📦 Dependencies & Packages

This project uses carefully selected packages across frontend and backend to deliver powerful features. Below is the complete list of dependencies organized by category.

🎨 Frontend Runtime Dependencies

Core Libraries

Document Processing & Export

Markdown & Math Rendering

Canvas & Graphics

Configuration & Environment

🛠️ Frontend Dev/Build Dependencies

Build Tools

Code Quality & Linting

Type Definitions

Utilities

⚙️ Backend Runtime Dependencies

Server Framework

Database

AI Integration

Configuration

🧪 Backend Dev/Test Dependencies

Testing Tools

📌 Key Dependencies Overview

Package	Purpose	Category
axios	HTTP client for API requests	Frontend - Network
react	UI framework for building interactive interfaces	Frontend - Core
docx	Create and export .docx documents	Frontend - Document Processing
html2pdf.js	Generate PDFs from HTML content	Frontend - PDF Generation
marked	Markdown parsing and rendering	Frontend - Markdown
katex	LaTeX math equation rendering	Frontend - Math Rendering
fabric	Canvas manipulation for whiteboard	Frontend - Graphics
xlsx	Excel file parsing and generation	Frontend - Data Import/Export
papaparse	CSV parsing and processing	Frontend - CSV Processing
express	Backend web framework	Backend - Server
mongoose	MongoDB object modeling	Backend - Database
@google/genai	Google Gemini AI integration	Backend - AI Services
vite	Fast build tool and dev server	Dev - Build Tool
eslint	Code linting and quality checks	Dev - Code Quality

Note: All dependencies are managed through npm. Badges display the latest available versions from the npm registry. The project uses semantic versioning (^) for flexible updates within major versions. See package.json files for exact version constraints used in this project.

📋 Prerequisites

Before you begin, ensure you have the following installed:

Node.js (v16.0.0 or higher)
npm (v7.0.0 or higher)
MongoDB (v4.4 or higher) - For data persistence across all features
Google Gemini AI API Key (for AI-powered text extraction and notes generation)
LongCat API Key (optional - for AI Assistant alternative models)
GitHub Personal Access Token (optional - for GitHub Models: GPT-4o, Claude, etc.)

🛠️ Installation

1. Clone the Repository

git clone https://github.com/H0NEYP0T-466/Pen2PDF.git
cd Pen2PDF

2. Install Frontend Dependencies

npm install

3. Install Backend Dependencies

cd backend
npm install

4. Database Setup

Ensure MongoDB is running on your system. The application uses multiple databases:

# Start MongoDB service (varies by OS)
# macOS (with Homebrew): brew services start mongodb-community
# Ubuntu: sudo systemctl start mongod
# Windows: net start MongoDB

The application will automatically create the following databases:

todolist - For todo management data
timetable - For timetable and schedule data
notes - For notes and study materials
chat - For AI assistant chat history

5. Environment Setup

Create a .env file in the backend directory:

cd backend
touch .env

Add your API keys to the .env file:

# Required: Google Gemini API for text extraction and notes generation
GEMINI_API_KEY=your_google_gemini_api_key_here

# Optional: LongCat API for AI Assistant alternative models
LONGCAT_API_KEY=your_longcat_api_key_here

# Optional: GitHub Personal Access Token for GitHub Models (GPT-4o, Claude, etc.)
# Get your PAT from https://github.com/settings/tokens with model access scope
githubModelsPAT=your_github_pat_here

GitHub Models Setup (Optional): To use GitHub Models (GPT-4o, GPT-4, Claude, etc.) in the AI Assistant:

Visit https://github.com/settings/tokens
Create a new Personal Access Token (classic)
- The exact scope requirements may depend on your GitHub subscription
- For GitHub Models access, your account needs GitHub Copilot or GitHub Models access
Ensure you have access to GitHub Models (included with GitHub Copilot or Student Developer Pack)
Copy the token and add it as githubModelsPAT in your .env file
The AI Assistant will automatically discover available models at runtime via the GitHub Models API

Note: Without a GitHub PAT, the AI Assistant will still work with LongCat and Gemini models. GitHub Models will be shown as "unavailable" in the model selector.

6. Start the Development Servers

Backend Server (Terminal 1)

cd backend
node index.js

Frontend Server (Terminal 2)

npm run dev

The application will be available at http://localhost:5173 (frontend) and the backend API at http://localhost:8000.

💻 Usage

The Pen2PDF Suite provides six main productivity tools accessible from the landing page. Each tool is designed to handle specific aspects of your workflow:

📝 Pen2PDF - Document Conversion

📤 Upload Files: Drag and drop or click to upload PDF, PPT, PPTX, or image files
🔄 Reorder Files: Use the up/down arrows to arrange files in the desired order
🤖 Extract Text: Click "Extract All" to process files using AI text extraction
✏️ Edit Content: Use the markdown editor to refine and format the extracted text
📄 Export: Download as PDF or markdown file

File Format Support

Format	Description	Notes
PDF	Portable Document Format	Supports text and image-based PDFs
PPT/PPTX	PowerPoint Presentations	Extract text from slides
PNG/JPG/WebP	Image Files	OCR text extraction from images

📅 Timetable Management

➕ Add Entries: Create individual timetable entries with subject, teacher, room, and timing details
📁 Import Data: Upload CSV, XLSX, or XLS files with bulk timetable data
📊 View Schedule: Browse your organized weekly schedule
✏️ Edit Entries: Modify existing timetable entries as needed
🗑️ Manage Data: Delete individual entries or clear entire schedule

Import File Format

Your import file should contain these columns:

Subject Name, Teacher Name, Class Number, Class Type, Timings, Day

✅ TodoList Management

📋 Create Cards: Add new todo cards for different projects or categories
➕ Add Subtasks: Break down cards into specific actionable subtasks
📌 Pin Important: Pin high-priority subtasks for easy access
✓ Track Progress: Mark subtasks as completed to monitor progress
📊 View Analytics: See completion statistics and progress overview

📚 Notes Generation & Library

📤 Upload Content: Upload files (PDF, PPTX, etc.) for note generation
🤖 Generate Notes: AI creates structured study notes from your content
✏️ Edit Notes: Refine generated notes using the markdown editor
💾 Save to Library: Store notes in your personal notes library
🔍 Browse Library: Access and search through your saved notes collection
📋 Blank Notes: Create notes from scratch without file upload

🤖 AI Assistant (Bella) Usage

💬 Start Chat: Open AI Assistant from the landing page
🔄 Select Model: Choose from LongCat or Gemini models in the dropdown
- LongCat models: Fast chat and thinking modes
- Gemini models: Advanced AI with file upload support
📎 Upload Files (Gemini only): Click upload button to add files as context
📚 Add Notes Context:
- Open context panel
- Search for relevant notes
- Check notes to include them as context
💬 Send Messages: Type your message and press Enter or click Send
🧠 Context-Aware Chat: AI remembers your last 20 messages for better conversations
📝 Rich Formatting: AI responses render with markdown, code blocks, and LaTeX math
💾 Conversation History: Your chat is automatically saved and loaded on next visit
🔄 Switch Models: Change models anytime to suit your needs

🎯 Navigation

🏠 Landing Page: Access all six tools from the main dashboard
🔙 Easy Return: Navigate back to the main menu from any tool
📱 Mobile Friendly: All features work seamlessly on mobile devices

📁 Project Structure

Pen2PDF/
├── 📁 public/                 # Static assets
│   └── favi.png              # Favicon
├── 📁 src/                   # Frontend source code
│   ├── App.jsx              # Main React application
│   ├── App.css              # Application styles
│   ├── main.jsx             # React entry point
│   ├── index.css            # Global styles
│   └── 📁 components/        # React components
│       ├── 📁 LandingPage/   # Main dashboard
│       │   ├── LandingPage.jsx
│       │   └── LandingPage.css
│       ├── 📁 Notes/         # Notes generation & library
│       │   ├── Notes.jsx
│       │   └── Notes.css
│       ├── 📁 Timetable/     # Schedule management
│       │   ├── Timetable.jsx
│       │   └── Timetable.css
│       ├── 📁 TodoList/      # Task management
│       │   ├── TodoList.jsx
│       │   └── TodoList.css
│       ├── 📁 AIAssistant/   # AI chat assistant
│       │   ├── AIAssistant.jsx
│       │   └── AIAssistant.css
│       └── 📁 WeekCounter/   # Week counter widget
│           ├── WeekCounter.jsx
│           └── WeekCounter.css
├── 📁 backend/               # Backend server
│   ├── 📁 controller/        # Request handlers
│   │   ├── controller.js     # Pen2PDF text extraction
│   │   ├── dbcontroller.js   # TodoList management
│   │   ├── timetableController.js  # Timetable management
│   │   ├── notesController.js      # Notes management
│   │   ├── whiteboardController.js # Whiteboard management
│   │   └── chatController.js       # Chat history management
│   ├── 📁 model/            # Database models
│   │   ├── todoData.js      # Todo data schema
│   │   ├── timetableData.js # Timetable data schema
│   │   ├── notesData.js     # Notes data schema
│   │   ├── whiteboardData.js # Whiteboard data schema
│   │   └── chatData.js      # Chat history schema
│   ├── 📁 config/           # Database configuration
│   │   └── database.js      # MongoDB connections
│   ├── 📁 gemini/           # Gemini AI integration
│   │   ├── gemini.js        # Pen2PDF text extraction
│   │   └── notesgemini.js   # Notes generation
│   ├── 📁 longcat/          # LongCat AI integration
│   │   └── longcat.js       # Chat API integration
│   ├── index.js             # Express server entry point
│   └── package.json         # Backend dependencies
├── 📄 README.md             # Project documentation
├── 📄 CHAT_CONTEXT_GUIDE.md # Chat context & formatting guide
├── 📄 TIMETABLE_IMPORT_GUIDE.md  # Timetable import guide
├── 📄 sample_timetable.csv  # Example timetable format
├── 📄 LICENSE               # MIT License
├── 📄 CONTRIBUTING.md       # Contribution guidelines
├── 📄 package.json          # Frontend dependencies
├── 📄 vite.config.js        # Vite configuration
├── 📄 eslint.config.js      # ESLint configuration
└── 📄 index.html            # HTML template

📦 Submodules

This project currently does not use any Git submodules. All dependencies are managed through npm package managers and are listed in the respective package.json files.

If you're looking to extend Pen2PDF with additional modules, please refer to our Contributing Guidelines for best practices on project architecture and integration.

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details on:

🔧 Setting up the development environment
📝 Code style and formatting requirements
🧪 Testing procedures
📋 Submitting pull requests
🐛 Reporting bugs
💡 Requesting features

📄 License

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

🛡️ Security

We take security seriously. If you discover a security vulnerability, please see our Security Policy for information on how to report it responsibly.

📏 Code of Conduct

This project follows the Contributor Covenant Code of Conduct. Please read our Code of Conduct to understand the expected behavior when participating in our community.

🗺️ Roadmap

✅ Current Features

📝 Pen2PDF: AI-powered text extraction using Google Gemini from multiple file formats
📅 Timetable: Complete schedule management with Excel/CSV import functionality
✅ TodoList: Task management with subtasks, pinning, and progress tracking
📚 Notes: AI-powered notes generation and searchable notes library
🎨 Whiteboard: Full-featured digital whiteboard with drawing, text, images, and export
🤖 AI Assistant (Bella): Multi-model AI chat with file upload and notes context
🎨 Unified Interface: Consistent design across all productivity tools
📱 Responsive Design: Full mobile and desktop compatibility
🔐 Data Persistence: MongoDB integration for all features

🚧 In Development

🔄 Cross-feature Integration: Link notes to specific timetable subjects and todo tasks
📊 Analytics Dashboard: Usage statistics and productivity insights across all tools
🎯 Smart Suggestions: AI-powered recommendations based on usage patterns
🔍 Global Search: Search across all notes, todos, and timetable entries
📅 Calendar Integration: Sync timetable with external calendar applications

🔮 Future Vision

☁️ Cloud Sync: Multi-device synchronization and backup
👥 Collaboration: Share timetables, notes, and todo lists with team members
📱 Mobile Apps: Native iOS and Android applications
🔌 API Integrations: Connect with popular productivity and educational tools
🎓 Academic Features: GPA tracking, assignment deadlines, exam scheduling
🤖 Advanced AI: Multi-provider AI support (OpenAI, Claude, etc.)
📈 Progress Analytics: Detailed productivity metrics and goal tracking
🎨 Customization: Themes, templates, and personalized workflows

🙏 Acknowledgements

Google Gemini AI - Powering our intelligent text extraction
React Team - For the amazing frontend framework
Vite - For blazing fast development experience
html2pdf.js - For client-side PDF generation
Marked - For markdown parsing and rendering
Express.js - For robust backend API development

Made with ❤️ by H0NEYP0T-466

Name		Name	Last commit message	Last commit date
Latest commit History 274 Commits
.github		.github
backend		backend
public		public
src		src
.env.example		.env.example
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
ENV_SETUP_GUIDE.md		ENV_SETUP_GUIDE.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
eslint.config.js		eslint.config.js
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
vite.config.js		vite.config.js

License

H0NEYP0T-466/Pen2PDF

Folders and files

Latest commit

History

Repository files navigation

📝 Pen2PDF

🔗 Links

📚 Table of Contents

🚀 Features

📝 Pen2PDF - AI-Powered Document Conversion

📅 Timetable Management

✅ TodoList - Task Management

📚 Notes Generation & Library

🤖 AI Assistant (Bella) - Intelligent Help

🌐 Universal Features

⚡ Tech Stack

Languages

Frontend Frameworks & Libraries

Backend Frameworks

Databases

AI

Tools & Libraries

DevOps & Development Tools

📦 Dependencies & Packages

🎨 Frontend Runtime Dependencies

Core Libraries

Document Processing & Export

Markdown & Math Rendering

Canvas & Graphics

Configuration & Environment

🛠️ Frontend Dev/Build Dependencies

Build Tools

Code Quality & Linting

Type Definitions

Utilities

⚙️ Backend Runtime Dependencies

Server Framework

Database

AI Integration

Configuration

🧪 Backend Dev/Test Dependencies

Testing Tools

📌 Key Dependencies Overview

📋 Prerequisites

🛠️ Installation

1. Clone the Repository

2. Install Frontend Dependencies

3. Install Backend Dependencies

4. Database Setup

5. Environment Setup

6. Start the Development Servers

Backend Server (Terminal 1)

Frontend Server (Terminal 2)

💻 Usage

📝 Pen2PDF - Document Conversion

File Format Support

📅 Timetable Management

Import File Format

✅ TodoList Management

📚 Notes Generation & Library

🤖 AI Assistant (Bella) Usage

🎯 Navigation

📁 Project Structure

📦 Submodules

🤝 Contributing

📄 License

🛡️ Security

📏 Code of Conduct

🗺️ Roadmap

✅ Current Features

🚧 In Development

🔮 Future Vision

🙏 Acknowledgements

About

Topics

Resources

License

Code of conduct

Contributing

Packages