How mrmps/classifier-dev works
classifier.dev is a hosted zero-shot text-classification service with a browser-facing account product. The main workflow accepts text and labels over HTTP, validates and budgets the request, classifies through Jev (with an LLM fallback), and returns labels with calibrated confidence. Its wider product includes account management, billing, usage analytics, agent interfaces, public documentation, and a separate agent-feedback protocol. The README documents several capabilities whose internals are not sampled; their paths and links are included only where supported by the tree and documentation.
Main entry points: server.ts Worker entry · index.ts Request router · jev.ts Jev classifier · feedback.ts Feedback protocol
Components 28
Classification API
- Worker entry
src/server.ts - Request router
src/index.ts - GET parsing
src/query.ts - Spending admission
src/spending/index.ts - Jev classifier
src/jev.ts - LLM fallback
src/index.ts - Free budget state
src/spending/free-budget.ts
Accounts and billing
- Account application
src/routes/app.tsx - Account API
src/http/account-api.ts - Account services
src/server/agents.ts - Account database
src/server/db.ts - Billing integration
src/server/billing.ts
Usage and operations
- Usage analytics
src/server/analytics/query.ts - Digest and alerts
src/report.ts
Agent interfaces
- MCP and skills
src/http/mcp.ts
Agent feedback
- Feedback protocol
src/feedback.ts - Feedback routes
src/http/dispatch.ts - Feedback records
src/feedback.ts
Public site
- Docs and homepage
src/docs.ts - Browser rendering
src/home.ts - classify CLI
cli/classify.js
Other components
- API caller
- TypeSafe service
- AI Gateway
- OpenRouter
- Autumn billing
- Analytics Engine
- Email delivery
Connections 30
- API caller → Worker entry: sends request
- Worker entry → Request router: dispatches request
- Request router → GET parsing: parses GET
- Request router → Spending admission: admits request
- Spending admission → Free budget state: reserves and settles
- Request router → Jev classifier: classifies inputs
- Jev classifier → TypeSafe service: requests probabilities
- Jev classifier → AI Gateway: tries first
- Request router → LLM fallback: falls back
- LLM fallback → OpenRouter: requests completion
- Request router → API caller: returns classification
- Worker entry → Account API: dispatches account requests
- Worker entry → Account application: streams app requests
- Account application → Account services: invokes account actions
- Account API → Account services: handles account operations
- Account services → Account database: reads and writes
- Worker entry → Billing integration: synchronizes billing
- Billing integration → Autumn billing: syncs customer state
- Worker entry → Usage analytics: serves account analytics
- Usage analytics → Analytics Engine: queries
- Digest and alerts → Analytics Engine: queries digest data
- Digest and alerts → Email delivery: sends digest and alerts
- API caller → MCP and skills: uses agent endpoints
- Worker entry → Feedback routes: routes feedback requests
- Feedback routes → Feedback protocol: dispatches feedback
- Feedback protocol → Feedback records: stores reports
- Feedback protocol → Email delivery: emails accepted reports
- API caller → Docs and homepage: requests documentation
- Docs and homepage → Browser rendering: renders for browsers
- classify CLI → API caller: submits API request