Files
personal-ai-assistant/README.md
dolgolyov.alexei b0790d719c Generalize from health-specific to universal personal assistant
The app manages multiple life areas (health, finance, personal, work),
not just health. Updated all health-specific language throughout:

Backend:
- Default system prompt: general personal assistant (not health-only)
- AI tool descriptions: generic (not health records/medications)
- Memory categories: health, finance, personal, work, document_summary, other
  (replaces condition, medication, allergy, vital)
- PDF template: "Prepared for" (not "Patient"), "Key Information" (not "Health Profile")
- Renamed generate_health_pdf -> generate_pdf_report, health_report.html -> report.html
- Renamed run_daily_health_review -> run_daily_review
- Context assembly: "User Profile" (not "Health Profile")
- OpenAPI: generic descriptions

Frontend:
- Dashboard subtitle: "Your personal AI assistant"
- Memory categories: Health, Finance, Personal, Work
- Document types: Report, Contract, Receipt, Certificate (not lab_result, etc.)
- Updated en + ru translations throughout

Documentation:
- README: general personal assistant description
- Removed health-only feature descriptions

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 15:15:39 +03:00

2.3 KiB

Personal AI Assistant

A client-server web application for managing different areas of personal life with AI-powered assistance. Upload documents, chat with AI specialists, receive proactive reminders, and track critical information across multiple life domains (health, finance, personal, work, etc.).

Key Features

  • AI Chat with Specialists — create chats using configurable skills (e.g., doctor, financial advisor, personal coach). Each skill shapes the AI's behavior as a domain expert.
  • Document Management — upload documents (records, reports, contracts, notes, etc.). AI extracts and indexes content for intelligent retrieval.
  • Proactive Notifications — AI analyzes your stored data and schedules reminders (deadlines, follow-ups, recurring events) via in-app, email, or Telegram.
  • PDF Compilation — request AI-generated summaries and reports as downloadable PDF documents.
  • Global Memory — AI maintains a shared memory of critical information across all your chats.
  • Multi-language — English and Russian support.

Tech Stack

Layer Technology
Backend Python 3.12, FastAPI, SQLAlchemy 2.0, Alembic
Frontend React 18, TypeScript, Vite, Shadcn/ui, Tailwind CSS
Database PostgreSQL 16
AI Claude API (Anthropic)
Notifications WebSocket, Email (SMTP), Telegram Bot
Deployment Docker Compose

Getting Started

Prerequisites: Docker and Docker Compose installed.

# Clone the repository
git clone https://git.dolgolyov-family.by/alexei.dolgolyov/personal-ai-assistant.git
cd personal-ai-assistant

# Copy environment config
cp .env.example .env
# Edit .env with your API keys and settings

# Start all services
docker compose up -d

# Create initial admin user
docker compose exec backend python scripts/seed_admin.py

The app will be available at http://localhost.

Project Structure

personal-ai-assistant/
├── backend/          # FastAPI application
├── frontend/         # React SPA
├── telegram-bot/     # Telegram notification bot
├── nginx/            # Reverse proxy config
├── plans/            # Phase subplans
├── docker-compose.yml
└── GeneralPlan.md    # Full implementation plan

License

Private project. All rights reserved.