Quickstart

Get Health Assistant up and running on your local machine using Docker in minutes.

Setup Instructions

1. Install Docker

Install Docker and Docker Compose on your system.

2. Clone the repository

bash

$git clone https://github.com/health-assistant-io/health-assistant.git

$cd health-assistant

3. Initialize environment & secure keys

Option A: Interactive Setup (Recommended)

Run the setup script to copy the template, automatically generate secure passwords and cryptographic keys, and interactively configure your settings:

$python scripts/setup_env.py

Option B: Manual setup

If you cannot run the Python script, copy the template manually. Note: If you choose manual setup, you must generate your own secure keys ( SECRET_KEY, POSTGRES_PASSWORD , etc.) and paste them into the .env file.

$cp .env.example .env

4. Configure remaining settings

Open the newly created .env file in your preferred text editor. While your secure keys are set (if you used Option A), you should review and adjust other configurations according to your environment.

5. Start the application

This uses the recommended "Standalone" flavor with a built-in Nginx proxy on port 80.

$docker compose --env-file .env -f docker/docker-compose.standalone.yml up -d

6. First-Time Data Seeding

You must manually seed the database and create your initial admin account. Run these commands sequentially:

$docker compose --env-file .env -f docker/docker-compose.standalone.yml exec backend python scripts/create_system_admin.py --email admin@example.com --password securepassword --tenant "My Organization"

$docker compose --env-file .env -f docker/docker-compose.standalone.yml exec backend python scripts/seed_biomarkers.py

$docker compose --env-file .env -f docker/docker-compose.standalone.yml exec backend python scripts/seed_allergies.py

$docker compose --env-file .env -f docker/docker-compose.standalone.yml exec backend python scripts/seed_medications.py

7. Access the application

Once the services are running, open your web browser and navigate to:

Main Application (Frontend): http://localhost
API Documentation (Backend): http://localhost/docs

Looking for more details?

For manual installation, production deployments, and detailed configuration, please refer to the core documentation repository:

View Full Documentation

Medical Disclaimer

Health Assistant is not a doctor. Information and AI-generated insights are for informational purposes only. Errors may occur. Always consult a certified medical professional.

Read Full Disclaimer