SHODIC

SHODIC is a free, anonymous-session AI pharmacy chat app with text-only chat, streaming responses, and optional RAG retrieval over drug information sources.

SHODIC provides general health and medication information only. It is not a substitute for professional medical advice, diagnosis, treatment, or emergency care.

Prerequisites

• Python 3.11+
• Node.js 18+
• SQLite for quick setup, or PostgreSQL through DATABASE_URL

Backend

cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.sample .env
python manage.py migrate
python manage.py runserver

Backend default: http://localhost:8000.

Create an admin user for source ingestion and admin management:

python manage.py createsuperuser

Frontend

cd frontend
npm install
npm run dev

Frontend default: http://localhost:5173. On localhost, VITE_API_BASE_URL can be omitted and the app uses http://localhost:8000.

Environment

Minimum local backend .env values:

SECRET_KEY=change-me
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1,[::1]
ALLOWED_ORIGINS=http://localhost:5173
DATABASE_URL=
OPENROUTER_API_KEY=your_openrouter_api_key
QDRANT_URL=
QDRANT_API_KEY=
OPENFDA_API_KEY=

For deployment, set DEBUG=False, use your deployed backend host in ALLOWED_HOSTS, use your frontend URL in ALLOWED_ORIGINS, and set DATABASE_URL. OpenRouter base URL, model, token limits, and Qdrant collection can be left unset unless you want to override the defaults.

Frontend .env is only needed when the API is not on localhost:

VITE_API_BASE_URL=http://localhost:8000

Deploy

Render backend:

Root Directory: backend
Build Command: pip install -r requirements.txt && python manage.py collectstatic --noinput
Start Command: python manage.py migrate --noinput && gunicorn config.wsgi:application --bind 0.0.0.0:$PORT
Included Paths: backend/**

Vercel frontend:

Root Directory: frontend
Framework Preset: Vite
Build Command: default
Output Directory: default
Install Command: default
Environment: VITE_API_BASE_URL=https://your-render-backend.onrender.com

API

The chat API lives under /shodic/:

• POST /shodic/send/
• GET /shodic/conversations/
• GET /shodic/conversations/<id>/
• PATCH /shodic/conversations/<id>/rename/
• DELETE /shodic/conversations/<id>/delete/
• PUT /shodic/messages/<id>/
• POST /shodic/messages/<id>/resend/

Checks

cd backend
python manage.py check
python manage.py test

cd ../frontend
npm run lint
npm run build

License

MIT