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:

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

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

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

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

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

4. 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. 💙}