Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/sagar-grv/ayush-synapse/llms.txt

Use this file to discover all available pages before exploring further.

Local development uses the built-in SQLite database, so PostgreSQL is not required. This setup is ideal for development, testing, and exploring the FHIR R4 API without any infrastructure overhead.
Prerequisites — Make sure you have the following installed before you begin:

Setup Steps

1

Clone the Repository

git clone <repository-url>
cd ayush-synapse
2

Create and Activate a Virtual Environment

python -m venv .venv
source .venv/bin/activate
Your terminal prompt will be prefixed with (.venv) once the environment is active.
3

Install Dependencies

pip install -r requirements.txt
This installs Flask, Flask-CORS, SQLAlchemy, PyJWT, Flask-Limiter, and all other required packages listed in requirements.txt.
4

Configure Environment Variables

Copy the provided example file to create your local configuration:
cp .env.example .env
The defaults in .env.example are pre-configured for local development with SQLite and demo mode enabled. No further edits are required to get started. See the Configuration reference for a full list of available variables.
5

Start the Development Server

python app.py
Flask will start on http://0.0.0.0:5000 by default. You should see output similar to:
* Running on http://0.0.0.0:5000
* Debug mode: off

Accessing the Application

Once the server is running, open your browser and navigate to any of the following paths:
PathInterface
http://127.0.0.1:5000/Main Interface — landing page with platform overview
http://127.0.0.1:5000/professional.htmlProfessional Dashboard — advanced search and dual coding tools for clinicians
http://127.0.0.1:5000/public.htmlPublic Dashboard — simplified condition search with multilingual support
http://127.0.0.1:5000/technical.htmlTechnical Dashboard — API testing and system monitoring
http://127.0.0.1:5000/apiAPI Overview — interactive API documentation

API Endpoints Quick Reference

The full interactive API reference is available at /api once the server is running. For a structured overview of every endpoint, authentication scheme, and example request/response, see the API Overview.
Run the bundled verification script to confirm that all components — database, authentication, FHIR resources, and API endpoints — are working correctly:
python verify_solution.py
A successful run prints a status report for each subsystem and exits with code 0.

Build docs developers (and LLMs) love