GitHub - GlycemicGPT/GlycemicGPT: Because no one should manage diabetes alone 💙

Open source diabetes platform with AI-powered analysis at its core. Because no one should manage diabetes alone.

Overview • Quick Start • Architecture • Roadmap • Development • Contributing • Support • Disclaimer

IMPORTANT SAFETY WARNING This software is NOT designed to replace your endocrinologist or healthcare provider. GlycemicGPT provides AI-generated suggestions only and should be used as a supplementary tool alongside professional medical care.

ALPHA SOFTWARE -- This project is under active development. It is functional and in daily use by the developer, but has not been broadly tested. Use at your own risk and always consult your healthcare provider.

Overview GlycemicGPT is an open source diabetes platform built around AI-powered analysis. It connects directly to your CGM and insulin pump for a full standalone experience — real-time monitoring, daily AI briefs, pattern detection, conversational AI chat, and caregiver alerting. Already running Nightscout? GlycemicGPT can also pull data from your existing instance and add AI analysis on top, no changes required to your current setup. See the Relationship to other tools page for the honest comparison. Currently supported devices:

Device Type Connection Status

Dexcom G7 CGM Cloud API Verified

Tandem t:slim X2 Insulin Pump BLE (direct) + Cloud API Verified

Tandem Mobi Insulin Pump BLE (direct) + Cloud API Protocol-compatible (see note)

Tandem Mobi note: The Mobi uses the same BLE protocol, authentication, and data formats as the t:slim X2. Our Tandem plugin reads data from both models, but Mobi support has not been verified against physical hardware. Protocol compatibility does not guarantee correct operation on untested devices. Use with Mobi hardware is entirely at your own risk — see MEDICAL-DISCLAIMER.md for full liability terms. If you have a Mobi and can help validate data reading, please open an issue.

Support for reading data from additional pumps and CGMs is planned.

The mobile app uses a capability-based plugin architecture for community device data drivers — see CONTRIBUTING.md if you'd like to help add data reading support for your device. If your device isn't supported today, the recommended path is the upcoming Nightscout integration — once that lands, anything that flows into Nightscout flows into GlycemicGPT. What it does:

AI-powered daily briefs, meal analysis, and pattern recognition (BYOAI — bring your own AI key) Conversational AI chat backed by clinical diabetes knowledge base Configurable alerts with caregiver escalation and multi-channel delivery (Telegram, push, in-app) Real-time glucose monitoring with trend charts and Time in Range tracking BLE connectivity to Tandem pumps (basal, bolus, IoB, reservoir, battery) Nightscout API integration for existing ecosystem users (coming soon) Android phone app + Wear OS companion with watch face complications Self-hosted Docker stack with web dashboard and REST API Up to 10 years of personal diabetes data storage Printable reports for endocrinologist appointments

Key Principles:

Suggestions only -- does not control medical devices BYOAI architecture -- bring your own AI provider (Claude, OpenAI, Ollama, or any OpenAI-compatible endpoint) Self-hosted -- your data stays on your infrastructure (Docker or Kubernetes) Safety-first -- pre-validation layer, emergency escalation, medical disclaimers

Quick Start

Looking for the friendly walkthrough? Read docs/get-started.md -- it covers the platform, the Android companion app, the optional watch face, AI provider configuration, and three deployment paths (laptop / home server with Cloudflare Tunnel / cloud VPS) end-to-end. The one-liner below is for developers who already know the stack.

git clone https://github.com/GlycemicGPT/GlycemicGPT.git cd GlycemicGPT cp .env.example .env docker compose up --build -d Services will be available at:

Web UI: http://localhost:3000 API: http://localhost:8000 API Docs: http://localhost:8000/docs

For deployments beyond local development, see:

Install with Docker -- the full

Docker reference + decision table for picking a compose example Install with Kubernetes -- Kustomize-based K8s walkthrough with prebuilt images deploy/examples/public-cloud/ -- VPS with Caddy + automatic HTTPS deploy/examples/cloudflare-tunnel/ -- home server with Cloudflare-managed access (no port forwarding required)

Architecture

Component Technology

Frontend Next.js 15, React 19, Tailwind CSS, shadcn/ui

Backend FastAPI, Python 3.12

Mobile Kotlin, Jetpack Compose, BLE

Wear OS Kotlin, Wear Compose, Watch Face

Plugin System Community device data drivers via plugin architecture

AI Sidecar TypeScript, Express, multi-provider proxy

Database PostgreSQL 16, SQLAlchemy 2.0

Cache Redis 7

Development # Start the full stack docker compose up --build -d

# Verify services curl localhost:8000/health # API curl localhost:3456/health # AI sidecar # Web UI at http://localhost:3000 See CONTRIBUTING.md for full development setup, branching strategy, and code style guidelines. Contributing We welcome contributions! Please read our Contributing Guide before submitting a pull request.

Bug Reports Feature Requests Mobile App Issues Discussions (questions, ideas, show & tell) Community Discord (real-time chat, questions, dev coordination)

Support the Project GlycemicGPT is free and open source. Funding flows through Open Collective, with full public transaction history. For a breakdown of how project funds are used, see the What the fund covers section in GOVERNANCE.md. Stars on GitHub help other people discover the project.

License This project is licensed under the GNU General Public License v3.0 (GPL-3.0). See the LICENSE file for details.

Disclaimer

See MEDICAL-DISCLAIMER.md for the complete medical and regulatory disclaimer.

USE AT YOUR OWN RISK

This Software is Not Medical Advice GlycemicGPT is experimental open-source software intended for educational and informational purposes only. It is NOT approved by the FDA or any regulatory body for medical use.

AI Limitations AI can and will make mistakes. Large language models (LLMs) are known to:

Hallucinate - generate plausible-sounding but incorrect information Misinterpret data - draw incorrect conclusions from your glucose readings Provide outdated information - not reflect the latest medical guidelines Lack context - not understand your complete medical history

Critical Warnings

Do not replace professional medical care. Always consult with your endocrinologist, diabetes educator, or healthcare provider before making any changes to your diabetes management.

Verify all suggestions. Any insulin dosing, carb ratio, or correction factor suggestions from AI must be verified with your healthcare team before use.

This is not a medical device. GlycemicGPT does not control any medical devices and provides suggestions only.

Use extreme caution. Incorrect diabetes management can result in severe hypoglycemia, diabetic ketoacidosis (DKA), or other life-threatening conditions.

Limitation of Liability THE AUTHORS AND CONTRIBUTORS OF THIS SOFTWARE ARE NOT LIABLE FOR ANY DAMAGES, INJURIES, OR ADVERSE HEALTH OUTCOMES RESULTING FROM THE USE OF THIS SOFTWARE. BY USING GLYCEMICGPT, YOU ACKNOWLEDGE THAT:

You are using this software at your own risk You will not rely solely on AI-generated suggestions for medical decisions You understand that AI can make errors and hallucinate You will maintain regular care with qualified healthcare professionals You accept full responsibility for any decisions made based on this software's output

If you experience a diabetes emergency, contact your healthcare provider or emergency services immediately. Do not rely on this software for emergency medical guidance.

Built with care for the diabetes community. Stay safe. 💙