The most comprehensive AI legal assistant ever created, powered by 805,000+ legal documents spanning the entire US legal system.

Build Status TypeScript License

• 31 Specialized Slash Commands - Law enforcement, tax law, contracts, and more
• 805,000+ Legal Documents - Complete US legal system coverage
• Voice Message Support - Whisper AI transcription
• Session Memory - 24-hour conversation history
• Smart Caching - 98% semantic similarity matching
• Production Ready - Health checks, metrics, logging, rate limiting

• Node.js 20+
• Redis
• API Keys: Slack, Anthropic (Claude), OpenAI, Pinecone

# Install dependencies
npm install
# Configure environment
cp .env.template .env
# Edit .env with your API keys
# Build
npm run build
# Start Redis
redis-server &
# Run
npm start

# Install Vercel CLI
npm i -g vercel
# Deploy
vercel
# Set environment variables in Vercel dashboard

npm run data:process-all

# Federal + State + Tax law
npm run data:all-law
# Or individually
npm run data:federal # 1.2 GB, 55k docs
npm run data:state # 2.6 GB, 510k docs
npm run data:tax # 1.3 GB, 225k docs

• /legal-help - General legal assistance
• /constitutional - Constitutional analysis
• /define - Legal term definitions
• /defend-rights - Legal defense guidance
• /sovereign-rights - Sovereign citizenship framework

• /traffic-stop - Real-time traffic stop defense
• /warrant-check - Warrant validity verification
• /miranda-rights - Miranda rights explanation
• /search-seizure - 4th Amendment rights
• /remain-silent - 5th Amendment guidance
• /right-to-counsel - 6th Amendment attorney rights
• /police-misconduct - File complaint guidance
• /arrest-rights - What to do when arrested
• /evidence-suppression - Motion to suppress evidence
• /qualified-immunity - Challenge qualified immunity

• /tax-strategy - Aggressive tax minimization
• /irs-audit - IRS audit defense
• /tax-deductions - Maximize deductions
• /tax-credits - All available credits
• /offshore-tax - International tax strategies
• /tax-court - Tax Court litigation
• /innocent-spouse - Innocent spouse relief
• /tax-liens - Handle IRS liens/levies
• /estimated-tax - Quarterly payment strategy
• /constitutional-tax - Constitutional tax challenges

• /contract-review - Contract analysis
• /legal-research - Case law research
• /file-lawsuit - Civil lawsuit guidance
• /appeal-case - Appellate procedure
• /pro-se - Self-representation guide

• /new-session - Reset conversation history

• GET /health - Service health check
• GET /metrics - System metrics

┌─────────────────────────────────────┐
│ Slack Interface │
│ 31 Commands + Voice + Sessions │
└──────────────┬──────────────────────┘
 │
┌──────────────┴──────────────────────┐
│ Enhanced Legal Slack Bot │
│ Session │ Cache │ Voice │ Legal │
└──────────────┬──────────────────────┘
 │
 ┌──────────┼──────────┐
 │ │ │
┌───▼───┐ ┌───▼────┐ ┌───▼─────┐
│ Redis │ │Pinecone│ │ Claude │
│ │ │ Vector │ │ Haiku │
│ │ │ DB │ │ 4.5 │
└───────┘ └────────┘ └─────────┘

See .env.template for all required variables:

• SLACK_BOT_TOKEN - Your Slack bot token
• SLACK_SIGNING_SECRET - Slack signing secret
• ANTHROPIC_API_KEY - Claude API key
• OPENAI_API_KEY - OpenAI API key (embeddings + Whisper)
• PINECONE_API_KEY - Pinecone vector DB key
• REDIS_URL - Redis connection URL

• One-Time: ~300ドル (embeddings)
• Monthly: ~250ドル-340 (Pinecone + APIs + hosting)
• Per-Query: ~0ドル.0001

# Development mode with auto-reload
npm run dev
# Build
npm run build
# Lint
npm run lint
# Format
npm run format
# Type check
npm run typecheck

• data:extract-pdf - Extract text from PDFs
• data:parse-definitions - Parse Black's Law Dictionary
• data:parse-constitutional - Parse Constitution
• data:parse-founding - Parse Founding Documents
• data:chunk - Chunk all documents
• data:embed - Generate embeddings
• data:load - Load to Pinecone
• data:process-all - Run full base pipeline
• data:federal - Process federal law
• data:state - Process state law
• data:tax - Process tax law
• data:all-law - Process ALL law data

# Run tests
npm test
# Test coverage
npm run test:coverage

Winston can integrate with n8n for workflow automation. See n8n-workflows/ directory for templates.

Example workflows:

• Automated legal research triggers
• Document processing pipelines
• Multi-agent legal analysis
• Scheduled report generation

• FINAL-COMPLETION-REPORT.md - Complete feature documentation
• PROGRESS-REPORT-SESSION-2.md - Development progress
• Agent OS Specs - Technical specifications

• Agent OS - Spec-driven development
• Claude-Flow - Multi-agent orchestration
• Claude Code - Implementation
• TypeScript - Type-safe code
• Slack Bolt - Slack integration
• Anthropic Claude - AI reasoning
• OpenAI - Embeddings & Whisper
• Pinecone - Vector database
• Redis - Caching & sessions

This is an educational AI assistant. It provides legal information, NOT legal advice. Always consult a licensed attorney for your specific legal situation.

MIT

Built using the Ultimate Coding Agent System:

• Agent OS by Builder Methods
• Claude-Flow by rUv
• Claude Code by Anthropic

Winston - Your AI Legal Defense Companion ⚖️🤖

Made with ❤️ using Agent OS + Claude-Flow + Claude Code