Chatty

A free, open-source personal AI agent platform built for small business owners.

Create custom AI agents with their own personality, knowledge, and tools — powered by your own API keys. No SaaS fees, no vendor lock-in. You only pay for the AI usage you consume.

Features

• Multi-agent — Create and manage multiple AI agents, each with its own name, personality, and knowledge base
• Multi-provider AI — Anthropic, OpenAI, and Google Gemini (bring your own API keys)
• Brandable — Upload your logo, company name, and accent color to make it yours
• Integrations — Gmail, Google Calendar, QuickBooks Online, WhatsApp, Telegram
• Local-first — SQLite database, no external services required
• One-click deploy — Deploy to Railway for access from any device

Quick Start

git clone https://github.com/WWilson1017/chatty.git
cd chatty
python run.py

The launcher checks prerequisites, creates a virtual environment, installs dependencies, and starts the server. Open http://localhost:8000 when it's ready.

Requirements

• Python 3.10+
• Node.js 18+

Configuration

Copy .env.example to .env and fill in your credentials:

• AUTH_PASSWORD — Your login password
• JWT_SECRET — A random secret for session tokens (auto-generated by run.py)
• AI provider credentials — At least one of: Anthropic API key, OpenAI API key, or Google AI API key

See .env.example for all available options including integrations.

Deploy to Railway

1. Click the button above and set your AUTH_PASSWORD (the only required input)
2. Railway builds and deploys your instance automatically
3. Open your Chatty URL, log in, and paste your AI provider API key in the setup wizard

JWT_SECRET and ENCRYPTION_KEY auto-generate if not set. Your data persists on a Railway volume.

For detailed instructions, custom domains, and troubleshooting, see DEPLOY.md.

Contributing

See CONTRIBUTING.md for how to submit changes.

Security

To report a security vulnerability, see SECURITY.md.

License

MIT