Agent Man

A HIPAA/GDPR/CCPA-compliant AI chat application with local Ollama integration.

Chat with AI models running entirely on your machine. Your data never leaves your computer.

🚀 Quick Start

Standard Installation

# Clone and install
git clone https://github.com/KenKaiii/chat-man.git
cd chat-man
bun install

# Build and start
bun run build
bun start

FR3KZ Enhanced Installation (Recommended)

# Install globally with FR3K integration
npm install -g fr3kz

# Launch enhanced Chat-Man with FR3K features
npx fr3kz

FR3KZ automatically finds an available port starting from 3010 and opens your browser.

For full FR3K features, install fr3kc0d3 locally:

npm install fr3kc0d3
# or
bun add fr3kc0d3

Platforms: macOS, Linux, WSL Requirements: Bun • Ollama (auto-installed if missing)

✨ Features

🤖 Local AI

• 100% local processing with Ollama
• No cloud, no API keys
• Support for Llama, Qwen, Mistral, and more
• Download models directly in the UI

💬 Rich Chat

• Real-time streaming responses
• Markdown with syntax highlighting
• Code blocks with copy
• Mermaid diagram rendering
• File attachments (drag & drop)
• Beautiful dark theme

🔍 RAG (Retrieval-Augmented Generation)

• Upload and search documents
• Vector database (LanceDB)
• Context-aware AI responses

🧠 FR3KZ - Advanced AI Integration

• Multi-Provider AI: Groq, OpenRouter (200+ models), DeepSeek
• Forge Patterns: 300+ battle-tested AI prompt patterns
• Sage Commands: 60+ specialized commands across 7 categories
• Nexus Context: Hierarchical project context management
• Flow Assistant: Collaborative multi-step workflows
• MCP Tools: 70+ external service integrations
• Dynamic Hooks: Automated validation and processing

🌐 Social Media Integration

• Share conversations to social platforms
• Twitter, Discord, Slack, and Reddit support
• No API keys required (uses web intents/webhooks)
• Configurable platform settings

🔐 Security & Privacy

• AES-256-GCM encryption
• No telemetry or tracking
• Session timeout (15 min)
• Audit logging
• Disk encryption enforcement (production)

🧠 FR3KZ - Advanced AI Features

FR3KZ transforms Chat-Man into a comprehensive AI development platform by integrating the complete FR3K ecosystem.

Multi-Provider AI Support

• Ollama: Local AI models (Llama, Qwen, Mistral) - 100% private
• Groq: Ultra-fast inference with Llama 3.3 70B models
• OpenRouter: Access to 200+ models (Claude 3.5 Sonnet, GPT-4, Gemini, DeepSeek R1)
• DeepSeek: Advanced reasoning capabilities

Forge Pattern System (300+ Patterns)

Execute battle-tested AI prompt patterns:

# Available through FR3KZ UI
- Extract Wisdom: Extract key insights from content
- Analyze Claims: Verify claims for accuracy and bias
- Improve Writing: Enhance clarity and impact
- Create Summary: Generate comprehensive summaries
- Explain Concept: Break down complex ideas

Sage Command System (60+ Commands)

Specialized AI commands across 7 categories:

• Analysis: analyze_claims, analyze_debate, analyze_prose
• Creation: create_summary, create_report, create_keynote
• Learning: explain_concept, create_quiz, create_study_guide
• Technical: explain_code, review_code, create_documentation
• Communication: improve_writing, create_email, translate_jargon
• Business: analyze_competitors, create_pitch, analyze_market
• Personal: create_plan, analyze_decision, extract_wisdom

Advanced Features

• Nexus Context Management: Hierarchical project contexts
• Flow Collaborative Workflows: Multi-step AI-guided processes
• Dynamic Hook System: Automated validation and processing
• MCP External Tools: 70+ integrations with external services

Getting Started with FR3KZ

# Install FR3KZ globally
npm install -g fr3kz

# Launch enhanced Chat-Man
npx fr3kz

# Access FR3K features through the FR3K button in the header

FR3KZ maintains full HIPAA/GDPR/CCPA compliance while adding enterprise-grade AI capabilities.

🔐 GDPR/HIPAA/CCPA Compliance

This application implements technical controls designed to support compliance.

⚠️ See "Legal Disclaimer" section below before using for regulated data.

Required: Enable Disk Encryption

macOS:

# Check status
fdesetup status

# Enable: System Preferences → Security & Privacy → FileVault

Linux:

# Check status
lsblk -o NAME,FSTYPE | grep crypto_LUKS

Compliance Features

• ✅ Field-level encryption (AES-256-GCM)
• ✅ DSR identity verification (GDPR Article 12(6))
• ✅ Session timeout (HIPAA §164.312(a)(2)(iii))
• ✅ 6-year audit retention (HIPAA §164.316(b)(2)(i))
• ✅ CCPA disclosures (1798.100)

Full details: See COMPLIANCE_AUDIT_REPORT.md

User Risk: ZERO ✅

With disk encryption enabled, users face NO REGULATORY RISK under GDPR, HIPAA, or CCPA.

⚠️ Legal Disclaimer

IMPORTANT: READ CAREFULLY BEFORE USE

This software implements technical controls designed to support HIPAA, GDPR, and CCPA compliance requirements. However:

Not Legal Advice

• This software and its documentation DO NOT constitute legal advice
• You are responsible for ensuring your own compliance with applicable laws
• Consult qualified legal counsel for compliance guidance specific to your use case

No Warranty of Compliance

• The software is provided "AS IS" WITHOUT WARRANTY OF ANY KIND
• The creators make NO REPRESENTATIONS OR WARRANTIES regarding regulatory compliance
• Compliance depends on your specific implementation, policies, and procedures
• You are solely responsible for verifying compliance with all applicable regulations

Your Responsibilities

As a user of this software, you must:

• Conduct your own compliance assessment
• Implement appropriate organizational policies and procedures
• Maintain proper documentation and training
• Consult legal and compliance professionals
• Regularly audit and update your compliance measures

Limitation of Liability

• The creators and contributors SHALL NOT BE LIABLE for any regulatory violations, fines, penalties, or damages
• Use of this software does not guarantee compliance with any law or regulation
• You assume all risks associated with using this software for regulated data

Regulatory Requirements Vary

• HIPAA, GDPR, and CCPA requirements vary by jurisdiction, organization, and use case
• Technical controls are only one component of regulatory compliance
• Full compliance requires organizational policies, training, risk assessments, and more

BY USING THIS SOFTWARE, YOU ACKNOWLEDGE THAT YOU HAVE READ THIS DISCLAIMER AND AGREE TO ITS TERMS.

📄 License

AGPL-3.0-or-later

Made with ❤️ by KenKai