Autonomous • Scalable • Production-Ready
Recora-X is an intelligent SaaS platform that transforms receipt processing through autonomous AI agents. Upload a PDF receipt, and watch as our multi-agent system extracts, validates, and structures financial data in real-time — no manual entry required.
Built with Anthropic Claude Sonnet 4.5 for intelligent extraction, orchestrated by Inngest Agents for reliable workflows, and powered by Convex for instant data synchronization.
"Think of it as your personal receipt accountant — powered by autonomous AI."
| 📤 Upload | 🤖 AI Processing | ✅ Structured Output |
|---|---|---|
| Drop any PDF receipt | Claude extracts merchant, items, totals | Get structured JSON in seconds |
Multi-agent coordination system where specialized AI agents handle scanning, validation, and storage autonomously.
Claude Sonnet 4.5 extracts merchant names, transaction dates, line items, and totals with high accuracy.
Inngest orchestrates agent operations through reliable event triggers and state management.
Convex ensures your UI reflects processing status instantly — no polling required.
Clerk authentication with user-isolated data ensures privacy and compliance.
Sleek UI built with Next.js 15, Tailwind 4, and Radix UI components for exceptional UX.
graph TB
subgraph "🖥️ Frontend Layer"
UI[Receipt Upload UI]
Dashboard[Dashboard & Analytics]
end
subgraph "⚙️ Backend Layer"
API[Convex API]
DB[(Receipts Database)]
Storage[(File Storage)]
end
subgraph "🤖 AI Agent Layer"
Network[Agent Network]
Scanner[Receipt Scanner Agent]
DBAgent[Database Agent]
Claude[Claude Sonnet 4.5]
end
subgraph "🔐 Auth Layer"
Clerk[Clerk Auth]
end
UI -->|Upload| API
API -->|Store File| Storage
API -->|Trigger| Network
Network -->|Initialize| Scanner
Scanner -->|Parse| Claude
Claude -->|Extract| Scanner
Scanner -->|Validate| DBAgent
DBAgent -->|Save| DB
DB -->|Subscribe| UI
Clerk -->|Authenticate| UI
style Claude fill:#9b87f5
style Network fill:#7c3aed
style UI fill:#3b82f6
style DB fill:#10b981
|
|
erDiagram
RECEIPTS ||--o{ ITEMS : contains
RECEIPTS {
string _id PK
string userId FK
string fileName
string status
string merchantName
string transactionDate
decimal transactionAmount
string currency
timestamp createdAt
timestamp processedAt
}
ITEMS {
string _id PK
string receiptId FK
string name
int quantity
decimal price
decimal subtotal
}
pending→ Upload complete, awaiting AI processingprocessing→ AI agent actively extracting dataprocessed→ Successfully extracted and storederror→ Processing failed, retry available
- Node.js 18+ or Bun 1.0+
- pnpm, npm, or yarn
- Accounts: Clerk, Convex, Inngest, Anthropic
# Clone repository
git clone https://github.com/ashutoshm97/recora-x.git
cd recora-x
# Install dependencies
pnpm install
# Copy environment template
cp .env.example .env.local# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...
# Convex
CONVEX_DEPLOYMENT=dev:...
NEXT_PUBLIC_CONVEX_URL=https://...
# Inngest
INNGEST_EVENT_KEY=...
INNGEST_SIGNING_KEY=...
# Anthropic
ANTHROPIC_API_KEY=sk-ant-...# Start Convex dev server
pnpm convex dev
# Start Next.js (in new terminal)
pnpm dev
# Start Inngest dev server (in new terminal)
pnpm inngest:devVisit http://localhost:3000 🎉
sequenceDiagram
participant 👤 User
participant 🖥️ UI
participant 📦 Convex
participant 🎯 Inngest
participant 🔍 Scanner
participant 🧠 Claude
participant 💾 DBAgent
👤->>🖥️: Upload PDF Receipt
🖥️->>📦: storeReceipt(file, userId)
📦->>📦: Save to File Storage
📦->>🎯: Emit "receipt.extract" event
🎯->>🔍: Initialize Scanner Agent
🔍->>🧠: Send PDF + Prompt
🧠-->>🔍: Return Structured JSON
🔍->>🔍: Validate Extraction
🔍->>💾: Pass Data to DB Agent
💾->>📦: updateReceipt(data)
📦-->>🖥️: Real-time Subscription Update
🖥️-->>👤: Show Processed Receipt
recora-x/
├── app/ # Next.js 15 App Router
│ ├── (auth)/ # Authentication routes
│ ├── (dashboard)/ # Protected dashboard
│ └── api/ # API routes
├── components/ # React components
│ ├── ui/ # Shadcn/ui primitives
│ ├── receipts/ # Receipt-specific components
│ └── layout/ # Layout components
├── convex/ # Convex backend
│ ├── schema.ts # Database schema
│ ├── auth.config.ts # Clerk integration
│ └── receipts.ts # Receipt operations
├── inngest/ # Inngest agents
│ ├── client.ts # Inngest client config
│ ├── agents/ # Agent definitions
│ │ ├── scanner.ts # Receipt scanner agent
│ │ └── database.ts # Database agent
│ └── functions/ # Inngest functions
├── lib/ # Utilities
│ ├── utils.ts # Helper functions
│ └── validations.ts # Zod schemas
└── public/ # Static assets
// Upload and trigger processing
uploadReceipt(file: File, userId: string): Promise<ReceiptId>
// Fetch user receipts
getReceipts(userId: string): Promise<Receipt[]>
// Get download URL
getFileDownloadUrl(fileId: string): Promise<string>
// Update with extracted data
updateReceiptWithExtractedData(
receiptId: string,
data: ExtractedData
): Promise<void>
// Delete receipt
deleteReceipt(receiptId: string): Promise<void>// Receipt Scanner Agent
receiptScannerAgent({
pdfUrl: string,
receiptId: string
}): Promise<ExtractedData>
// Database Agent
databaseAgent({
receiptId: string,
extractedData: ExtractedData
}): Promise<void>Clean, intuitive interface for managing all your receipts
Watch in real-time as AI extracts your receipt data
Structured, searchable receipt information
# Run unit tests
pnpm test
# Run E2E tests
pnpm test:e2e
# Type checking
pnpm type-check
# Linting
pnpm lint# Deploy to Vercel
vercel deploy --prod
# Configure environment variables in Vercel dashboard- Build the application:
pnpm build - Deploy Convex:
npx convex deploy - Configure Inngest production keys
- Deploy to your hosting platform
- Batch Processing - Upload and process multiple receipts simultaneously
- Smart Categories - AI-powered expense categorization
- Analytics Dashboard - Spending insights and visualizations
- Export Options - Google Sheets, Excel, Notion integrations
- Mobile App - Native iOS/Android applications
- Voice Upload - Speech-to-data receipt entry
- OCR Enhancement - Support for photographed receipts
- Multi-language - Support for international receipts
Contributions make the open-source community amazing! Any contributions you make are greatly appreciated.
# Fork the repository
# Create your feature branch
git checkout -b feature/AmazingFeature
# Commit your changes
git commit -m 'feat: add some AmazingFeature'
# Push to the branch
git push origin feature/AmazingFeature
# Open a Pull RequestWe follow Conventional Commits specification.
Distributed under the MIT License. See LICENSE for more information.
Full-Stack Engineer • AI Systems Architect • Cloud Solutions Developer
Building scalable agentic workflows that integrate cutting-edge LLMs with real-time databases.
- Anthropic for Claude AI
- Convex for the real-time backend
- Inngest for reliable agent orchestration
- Vercel for seamless deployment
- Clerk for authentication
Recora-X • Automating Receipts. Empowering Agents.
Built with ❤️ using Next.js • Convex • Inngest • Claude AI
⭐ Star this repo if you find it helpful!