jwuthri-cloud / Scribely

# Scribely
> 🤖 **Modern AI Chat Application** built with **FastAPI** + **Next.js** + **OpenRouter** + **Clerk** _ **Vercel** + **Railway**
A simple, production-ready AI chat application featuring unified access to 500+ language models via OpenRouter, Clerk authentication, and a terminal-style interface.
---
## 🌟 **Features**
### 🧠 **AI Capabilities**
- **500+ Models** via OpenRouter (GPT-5, Claude 3.7, Gemini 2.5 Pro, Llama 3.3, etc.)
- **LangChain Integration** for LLM interactions
- **Simple Q&A Interface** - Terminal-style chat UI
- **Stateless Conversations** - No session storage, reload resets
### 🔐 **Authentication**
- **Clerk Integration** - Google OAuth authentication
- **JWT Token Validation** - Secure API access
- **User Profile Management** - Clerk-based user system
### 🚀 **Production-Ready Architecture**
- **FastAPI Backend** with async/await support
- **Next.js Frontend** with App Router and TypeScript
- **Docker Compose** setup for development and production
- **Health Checks** and monitoring endpoints
### 🔧 **Developer Experience**
- **`uv`** for ultra-fast Python dependency management
- **Hot Reload** in development
- **Comprehensive Logging** with structured logging
- **Type Safety** with Pydantic and TypeScript
---
## 🏗️ **Architecture**
 [code] 
---
## 💻 **Desktop app (macOS)**
The **Electron** overlay lives in **`desktop/`**. Users install from a signed **DMG**; **in-app updates** use electron-updater and load **`latest-mac.yml`** plus ZIP artifacts from **GitHub Releases — Scribely-Release** (a dedicated release repo, not necessarily the same repo as application source).
- **Developer details:** desktop/README.md (build, release checklist, `SCRIBELY_DISABLE_AUTO_UPDATE`)
- **Live agent (Google Doc + standing task, write-back, simulator):** desktop/README.md → Live agent
- **Architecture:** PROJECT.md
---
## 🚀 **Quick Start**
### 1. **Prerequisites**
 [code] 
### 2. **Environment Setup**
 [code] 
### 3. **Start with Docker Compose** ⚡
 [code] 
### 4. **Manual Development Setup** 🛠️
 [code] 
### 5. **Access Your Application** 🎉
- **Frontend**: http://localhost:3000
- **Backend API**: http://localhost:8000
- **API Docs**: http://localhost:8000/docs
- **ReDoc**: http://localhost:8000/redoc
---
## 🤖 **AI Model Selection**
Choose from 500+ models available through OpenRouter:
 [code] 
---
## 📚 **API Endpoints**
### **Authentication (Clerk)**
 [code] 
### **Chat**
 [code] 
### **Health & Metrics**
 [code] 
---
## 🔧 **Configuration**
### **Backend Settings** (`backend/.env`)
 [code] 
### **Frontend Settings** (`frontend/.env.local`)
 [code] 
---
## **Test**
### Commands (quick reference)
| Area | Command |
|------|---------|
| Desktop | `cd desktop && npm test` |
| Backend | `cd backend && pytest` |
| Extension | `cd chrome-extension && npm test` |
| Frontend unit | `cd frontend && npm test` |
| Frontend E2E | `cd frontend && npm run test:e2e` |
---
## 🚢 **Deployment**
### **Using Docker** (Recommended)
 [code] 
### **Manual Deployme