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.

Ayush Synapse is a FHIR R4-compliant microservice that maps NAMASTE (National AYUSH Morbidity and Standardized Terminologies Electronic) codes to ICD-11 TM2 and Biomedicine codes, enabling seamless interoperability between traditional Indian medicine systems and modern Electronic Medical Record (EMR) platforms — in compliance with India’s 2016 EHR Standards.

Quickstart

Run the server and make your first API call in under 5 minutes.

API Reference

Explore all REST endpoints — coding systems, mappings, FHIR resources, and more.

Demo Mode

Try every feature without registration using the built-in demo token.

Docker Deployment

Deploy with Docker Compose for cloud or on-premise environments.

​
What Ayush Synapse Does

Ayush Synapse solves the interoperability gap between traditional AYUSH coding systems (Ayurveda, Siddha, Unani) and internationally recognized ICD-11 codes. It exposes a REST API that clinicians, developers, and health informatics teams can integrate directly into their EMR workflows.

Code Mapping

85+ pre-built NAMASTE-to-ICD-11 mappings with confidence scores.

FHIR R4

Native CodeSystem, ConceptMap, and Bundle resources for standards-based exchange.

Multilingual

Interface and search available in 16 Indian languages.

Secure Auth

JWT-based authentication with ABHA token support and role-based access.

Real-Time Search

Search across NAMASTE, ICD-11 TM2, and Biomedicine codes simultaneously.

Role Dashboards

Separate portals for clinicians, public users, and developers.

​
Get Up and Running

1

Clone and install

Clone the repository and install Python dependencies into a virtual environment.
git clone https://github.com/sagar-grv/ayush-synapse.git
cd ayush-synapse
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
2

Configure environment

Copy the example environment file and adjust values as needed.
cp .env.example .env
3

Start the server

python app.py
The API is available at http://127.0.0.1:5000.
4

Make your first request

Obtain a demo token and query the NAMASTE codes endpoint.
TOKEN=$(curl -s -X POST http://127.0.0.1:5000/auth/login \
  -H "Content-Type: application/json" \
  -d '{"user_id":"demo_user","role":"clinician"}' | python3 -c "import sys,json; print(json.load(sys.stdin)['token'])")

curl -H "Authorization: Bearer $TOKEN" http://127.0.0.1:5000/namaste

​
Explore by Role

Clinicians & Researchers

Use the Professional Dashboard for advanced search and dual-coding workflows.

Public Users

Simple condition search and health awareness via the Public Dashboard.

Developers

API testing, system monitoring, and integration guides in the Technical Dashboard.

Build docs developers (and LLMs) love

Get started for freeTalk to us