# SAFIA

## Docs

- [SAFIA Knowledge Base: Uploading and Managing Documents](https://safia.maximusolution.com/admin/knowledge-base.md): Upload PDF, TXT, and DOCX files so SAFIA can answer questions grounded in your own content using local embeddings and on-device vector search.
- [SAFIA Admin Dashboard: Usage Metrics and Navigation](https://safia.maximusolution.com/admin/overview.md): Monitor daily usage, track 30-day activity trends, and navigate to user management, access control, and knowledge base tools from one place.
- [SAFIA Admin: User Management and Bot Access Control](https://safia.maximusolution.com/admin/user-management.md): Browse registered Telegram accounts, switch between open and allowlist access modes, and update SAFIA's live configuration from the Settings page.
- [SAFIA Telegram Bot Commands, Rate Limits & Chat Context](https://safia.maximusolution.com/bot/commands.md): Learn how to talk to SAFIA on Telegram — the two slash commands, daily rate limits, chat context window, and access control explained.
- [SAFIA Long-Term Memory: Preferences, Goals & Habits](https://safia.maximusolution.com/bot/memory.md): SAFIA remembers facts about you across sessions — from savings goals to spending preferences — and surfaces them automatically when they're relevant.
- [Using Voice Messages and Receipt Photo Scanning in SAFIA](https://safia.maximusolution.com/bot/voice-and-photos.md): Send a voice note or snap a receipt photo in Telegram — SAFIA transcribes your audio via Whisper and scans documents with a vision model automatically.
- [safia CLI Commands: Full Subcommand Reference Guide](https://safia.maximusolution.com/cli/commands.md): Detailed reference for every safia CLI command — syntax, behavior, options, and example output for setup, daemon management, and maintenance.
- [SAFIA Environment Variables: Full Reference Guide](https://safia.maximusolution.com/cli/env-variables.md): Complete reference for every SAFIA environment variable — required fields, LLM settings, admin dashboard, knowledge base, and bot behavior tuning.
- [SAFIA LLM Providers: Lunos, Groq, OpenAI and Custom](https://safia.maximusolution.com/cli/llm-providers.md): Configure SAFIA to use Lunos, Groq, OpenAI, or any OpenAI-compatible API — including OpenRouter and LM Studio — for chat completions and vision.
- [SAFIA CLI Overview: Install and Quick Start Guide](https://safia.maximusolution.com/cli/overview.md): Learn how to install and use the safia CLI to set up, control daemons, and maintain your SAFIA Telegram bot instance from the command line.
- [SAFIA Configuration: Environment Variables Reference](https://safia.maximusolution.com/configuration.md): A full reference for SAFIA's .env variables: required credentials, LLM providers, database backends, admin auth, and knowledge base configuration.
- [SAFIA FAQ: Common Setup, Privacy and Usage Questions](https://safia.maximusolution.com/faq.md): Answers to the most common questions about SAFIA — setup, privacy, supported providers, languages, data storage, and day-to-day usage limits.
- [Expense & Income Tracking with SAFIA](https://safia.maximusolution.com/features/expense-tracking.md): Record expenses, income, and debts through natural Telegram chat. Filter your history, get financial summaries, and manage your money effortlessly.
- [Investment Portfolio Tracking with SAFIA](https://safia.maximusolution.com/features/investment-portfolio.md): Track stocks, crypto, gold, silver, and forex in one place. Get real-time valuations in IDR, rebalancing suggestions, and FIFO sell calculations.
- [Knowledge Base — Document-Grounded Answers in SAFIA](https://safia.maximusolution.com/features/knowledge-base.md): Upload PDF, TXT, or DOCX files via the admin dashboard so SAFIA can answer user questions grounded in your own documents and policies.
- [Live Market Data & Financial News in SAFIA](https://safia.maximusolution.com/features/market-data.md): Get real-time gold, silver, crypto, stock, and forex prices in IDR — plus Indonesian financial news summaries — all through natural Telegram chat.
- [Automated Reminders & Financial Alerts in SAFIA](https://safia.maximusolution.com/features/reminders.md): Set price alerts, daily news digests, expense nudges, and portfolio summaries through natural chat. SAFIA also suggests reminders based on your habits.
- [Meet SAFIA: Your AI-Powered Personal Finance Assistant](https://safia.maximusolution.com/introduction.md): SAFIA is a self-hosted Telegram bot that tracks expenses, manages portfolios, and delivers financial insights through natural conversation on your machine.
- [Quickstart: Install SAFIA and Run Your Finance Bot](https://safia.maximusolution.com/quickstart.md): Install SAFIA on your machine, run the setup wizard, and send your first message to your personal finance bot on Telegram — all in under five minutes.
- [Troubleshooting SAFIA: Diagnose and Fix Bot Issues](https://safia.maximusolution.com/troubleshooting.md): Diagnose and fix the most common problems with your SAFIA bot — from connection errors and rate limits to voice transcription and the admin dashboard.