Readur 📄

A powerful, modern document management system built with Rust and React. Readur provides intelligent document processing with OCR capabilities, full-text search, and a beautiful web interface designed for 2026 tech standards.

✨ Features

• 🔐 Secure Authentication: JWT-based user authentication with bcrypt password hashing
• 📤 Smart File Upload: Drag-and-drop support for PDF, images, text files, and Office documents
• 🔍 Advanced OCR: Automatic text extraction using Tesseract for searchable document content
• 🔎 Powerful Search: PostgreSQL full-text search with advanced filtering and ranking
• 👁️ Folder Monitoring: Non-destructive file watching (unlike paperless-ngx, doesn't consume source files)
• 🎨 Modern UI: Beautiful React frontend with Material-UI components and responsive design
• 🐳 Docker Ready: Complete containerization with production-ready multi-stage builds
• ⚡ High Performance: Rust backend for speed and reliability
• 📊 Analytics Dashboard: Document statistics and processing status overview

🚀 Quick Start

# Clone the repository
git clone https://github.com/perfectra1n/readur
cd readur

# Start all services
docker compose up --build -d

# Access the application
open http://localhost:8000

Default login credentials:

• Username: admin
• Password: readur2024

⚠️ Important: Change the default admin password immediately after first login!

📚 Documentation

Getting Started

• 📦 Installation Guide - Docker & manual installation instructions
• 🔧 Configuration - Environment variables and settings
• 📖 User Guide - How to use Readur effectively

Deployment & Operations

• 🚀 Deployment Guide - Production deployment, SSL, monitoring
• 🔄 Reverse Proxy Setup - Nginx, Traefik, and more
• 📁 Watch Folder Guide - Automatic document ingestion

Development

• 🏗️ Developer Documentation - Architecture, development setup, testing
• 🔌 API Reference - REST API documentation

Advanced Topics

• 🔍 OCR Optimization - Improve OCR performance
• 🗄️ Database Best Practices - Concurrency and safety
• 📊 Queue Architecture - Background job processing

🏗️ Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   React Frontend │────│   Rust Backend  │────│  PostgreSQL DB  │
│   (Port 8000)   │    │   (Axum API)    │    │   (Port 5433)   │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         │              ┌─────────────────┐             │
         └──────────────│  File Storage   │─────────────┘
                        │  + OCR Engine   │
                        └─────────────────┘

📋 System Requirements

Minimum

• 2 CPU cores, 2GB RAM, 10GB storage
• Docker or manual installation prerequisites

Recommended for Production

• 4+ CPU cores, 4GB+ RAM, 50GB+ SSD
• See deployment guide for details

🤝 Contributing

We welcome contributions! Please see our Contributing Guide and Development Setup for details.

🔒 Security

• Change default credentials immediately
• Use HTTPS in production
• Regular security updates
• See deployment guide for security best practices

📝 License

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

🙏 Acknowledgments

• Tesseract OCR for text extraction
• Axum for the web framework
• Material-UI for the beautiful frontend components
• PostgreSQL for robust full-text search

📞 Support

• Documentation: Start with the User Guide
• Issues: Report bugs on GitHub Issues
• Discussions: Join our GitHub Discussions

---

Made with ❤️ and ☕ by the Readur team