Documentation

Installation Guide

MediAssist – AI Health Triage Web App with Real-Time Symptom Analysis

Step-by-step Setup Verified Instructions Chat Support
Back to Project
Complete Guide

Installation Guide

Follow the steps below to set up and run MediAssist on your local machine. The entire setup takes approximately 10 to 15 minutes.

Prerequisites

Python Version 3.10 or higher
pip Included with Python installation
Groq API Key Free key available at console.groq.com
01

Clone the Project

Download the project source code to your local machine using Git.

Terminal
git clone <your-repo-url>
cd "AI Health Triage Agent User describes symptoms"
02

Create and Activate Virtual Environment

A virtual environment keeps your project dependencies isolated from your global Python installation.

Create Environment
python -m venv venv
Activate — Windows
venv\Scripts\activate
Activate — macOS / Linux
source venv/bin/activate
03

Install Dependencies

Install all required Python packages including Django, the Groq client library, and python-dotenv.

Terminal
pip install -r requirements.txt
04

Set Up Environment Variables

Create your local environment file from the provided template and add your API credentials.

Windows
copy .env.example .env
macOS / Linux
cp .env.example .env

Open the .env file and fill in the following values:

.env
GROQ_API_KEY=your_groq_api_key_here
DJANGO_SECRET_KEY=some-long-random-string-at-least-50-chars
DEBUG=True
Tip Generate a strong secret key by running: python -c "import secrets; print(secrets.token_hex(50))"
05

Run Database Migrations

This creates the SQLite database file and all required tables. You only need to run this once.

Terminal
python manage.py makemigrations triage
python manage.py migrate
06

Start the Development Server

Launch the application and open it in your browser.

Terminal
python manage.py runserver
Open Visit http://127.0.0.1:8000 in your browser
Run on a Different Port
python manage.py runserver 8080
Allow Local Network Access
python manage.py runserver 0.0.0.0:8000

Common Errors and Fixes

no such table: triage_conversation
You have not run migrations yet. Run python manage.py makemigrations triage followed by python manage.py migrate.
GROQ_API_KEY not working / 401 Error
Verify that your .env file exists and contains a valid key. Make sure your virtual environment is activated and check the key status at console.groq.com.
ModuleNotFoundError: No module named 'groq'
Your virtual environment is not activated or dependencies are not installed. Run venv\Scripts\activate on Windows or source venv/bin/activate on macOS/Linux, then run pip install -r requirements.txt.
Words appear concatenated with no spaces
Ensure you have the latest version of index.html. The fix is to never call .trim() on SSE data: field values in the JavaScript parser.
Port already in use
Run the server on an alternate port: python manage.py runserver 8080
Sidebar shows "Could not load history"
The server returned an error for the GET /conversations/ request. Check your terminal for a Django traceback. The most likely cause is that migrations have not been run.

Need Help?

Our team is here to assist you with installation and setup.

Chat with Us
Chat with us