ThothCloud is an industrial-grade private cloud ecosystem designed for high-security environments, media professionals, and data sovereign users. It combines a high-performance FastAPI backend with a stunning Glassmorphic React interface.
- Argon2id Hashing: Utilizing industry-best standards for password entropy and protection.
- Stateless JWT Security: High-entropy tokenization with secure rotation and expiration policies.
- Audit Sentinel: Deep activity tracking records every action (Login, IP, Timestamp, User context) for forensic accountability.
- Secure Isolation: Directory-level locking and recursive permission validation.
- Atomic Chunked Uploads: Handle multi-GB files with ease via segmented uploads, parallel processing, and resilient reassembly.
- Media Engine: Real-time FFmpeg Transcoding allows for fluid media streaming even on low-bandwidth connections.
- Async Core: Driven by a high-concurrency event loop, optimized for both high-end servers and low-power ARM devices.
- Fluid Glassmorphism: A multi-layered, interactive interface designed for modern aesthetics and reduced cognitive load.
- Dynamic Theme Engine: Instant transitions between Cyber Dark, Stellar White, and High Contrast modes.
- Advanced Media Suite: Native support for 4K video, lossless audio (FLAC/WAV), PDF rendering, and high-fidelity image previews.
| Component | Technology | Role |
|---|---|---|
| Backend | Python 3.10+ / FastAPI | Core logic, API routing, and async processing. |
| Frontend | React 18 / Vite | modern, responsive, and theme-aware dashboard. |
| Database | SQLite / SQLAlchemy | Relational data management with ACID compliance. |
| Styling | Tailwind CSS 4 | Atomic utility design with custom glassmorphism. |
| Media | FFmpeg | Real-time video processing and transcoding. |
| Security | Argon2 / JWT | Industry-standard hashing and stateless auth. |
Before starting, ensure you have the following installed:
- Python 3.10+
- Node.js 18+
- FFmpeg (For media streaming features)
The fastest way to get ThothCloud up and running. This script handles virtual environments, dependency installation (on first run), and starts both servers.
python start.pyBackend (Python):
cd backend
python -m venv venv
# Windows:
.\venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --host 127.0.0.1 --port 8000 --reloadFrontend (React/Vite):
cd frontend
npm install
npm run dev| Endpoint | Method | Scope | Description |
|---|---|---|---|
/auth/login |
POST |
Public | Authenticate and retrieve secure JWT session. |
/files/list |
GET |
User | Fetch recursive file/folder hierarchy. |
/files/upload-chunk |
POST |
User | Multi-threaded segmented large file transfer. |
/files/stream/{id} |
GET |
User | Low-latency streaming with transcoding (quality=720p). |
/share/{uuid} |
GET |
Public | High-speed access to shared Uplinks. |
/settings/ |
GET/PATCH |
Admin | System-wide configuration management. |
├── backend/ # FastAPI Async Engine & Logic Core
│ ├── auth.py # Authentication & Encryption logic
│ ├── files.py # File management & Chunking engine
│ ├── main.py # Entry point & API orchestration
│ ├── models.py # DB Schemas & Forensic Audit Definitions
│ └── requirements.txt# Python dependencies
├── frontend/ # React + Vite Professional UI
│ ├── src/components/ # Modular, theme-aware UI components
│ ├── src/api.js # Centralized Axios configuration
│ └── index.css # Design System tokens
├── storage/ # Physical Data Isolation Node
└── start.py # Unified Python orchestrator
- Contribute: Please review the Contributing Guidelines before submitting PRs.
- Issues: Report bugs or request features via the GitHub Issues tab.
- License: Hosted under the ThothCloud Open-Sovereign License.
Built for Sovereignty. Optimized for Performance.