πŸ“₯ Complete Download & Deploy Guide

Get Medgent Running
in 5 Minutes

Download the open-source code, upload to GitHub, deploy to a server, and start chatting with your AI health manager on WhatsApp or Telegram.

⬇️ Download Medgent β€” Free & Open Source
Everything you need in one ZIP file Β· 847 KB Β· Open Source
⬇️ Download medgent.zip β€” FREE ⭐ View on GitHub (star if you like it!)
Works on Windows, Mac, Linux, Android (via Termux) Β· Python 3.11+ required
OR β€” paste this in any terminal / server:
Terminal / SSH
curl -fsSL https://get.medgent.in | bash

Run Medgent on Your Phone or Computer

Start here if you just want to try Medgent. No server needed β€” runs right on your device.

1
Install Python (takes 2 minutes)
Python is the language Medgent is written in. It's free.
1a
πŸ†“ Free

Download Python

Go to python.org/downloads β€” click the big yellow button. Run the installer. Done.

πŸ’‘
Windows users: When the installer opens, tick the box that says "Add Python to PATH" β€” this is important! Then click Install Now.
1b
⏱ 30 seconds

Verify Python installed

Open Terminal (Mac/Linux) or Command Prompt (Windows) and type:

Terminal
python --version
# Should show: Python 3.11.x or higher
2
Download and Set Up Medgent
Get the code and run the wizard.
2a
⬇️ Download

Download the ZIP file

Click the big download button above, or use this command:

Terminal
git clone https://github.com/medgent/medgent.git
cd medgent
πŸ“Œ
No Git? Just download the ZIP from the button above, unzip it, then open Terminal in that folder.
2b
⏱ 1 minute

Install dependencies

This installs all the helper libraries Medgent needs.

Terminal β€” inside the medgent folder
pip install -r requirements.txt
# Wait ~30 seconds while packages download...
# You'll see "Successfully installed..." when done βœ…
2c
✨ Easiest step

Run the Setup Wizard

This guided wizard asks you 8 questions and sets everything up automatically.

Terminal
python setup.py
🎯
The wizard guides you step by step. It's like filling out a form. You'll choose your AI (Claude, ChatGPT, etc.), connect your chat app, and set your health profile.
2d

Start Medgent!

Once setup is complete, run this to start your health manager:

Terminal
bash scripts/start.sh
# OR for Telegram only:
python channels/telegram_bot.py
# OR for WhatsApp only:
python channels/whatsapp_bot.py
πŸŽ‰
That's it! Open your Telegram or WhatsApp and message your Medgent bot. Send /start on Telegram to begin.

Download Medgent from GitHub

This makes your Medgent version available to anyone in the world to download. It's like creating your own app store listing β€” free forever on GitHub.

ℹ️
Why GitHub? GitHub is like Google Drive for code. Millions of developers use it. When you put Medgent on GitHub, anyone anywhere in the world can download and run it with one click. And it's completely free.
1
Create Your Free GitHub Account
Takes 2 minutes. Like signing up for Gmail.
1
πŸ†“ Free forever

Visit the Medgent GitHub page

Go to https://github.com/medgent/medgent β€” the Medgent code is already there. Click the green Code button β†’ Download ZIP.

2
Visit the Medgent GitHub Page
The Medgent code is already on GitHub β€” just download it!
2a

Visit the Medgent GitHub page

Go to https://github.com/medgent/medgent β€” the code is already there, ready to download.

πŸ“
On the GitHub page you'll see a green "Code" button.
Click it β†’ choose "Download ZIP"

Or use this direct link:
https://github.com/medgent/medgent/raw/refs/heads/main/medgent-v2.0.zip
3
Upload Your Medgent Files
Two ways β€” use whichever is easier for you.
3A
πŸ‘† Easiest β€” No Terminal

Download via GitHub website

The easiest way β€” no terminal, no coding, just click.

  1. Go to https://github.com/medgent/medgent
  2. Click the green "Code" button
  3. Click "Download ZIP"
  4. Unzip the file β†’ you have Medgent! βœ…
3B
⌨️ Terminal Method

Clone via terminal (Git commands)

Faster once you know it. Replace YOUR-USERNAME with your GitHub username.

Terminal β€” inside your medgent folder
# Initialize Git in your medgent folder
git init
git add .
git commit -m "Initial Medgent release πŸ₯"
git branch -M main

git push -u origin main
# βœ… Done! Your code is now on GitHub
🌍
Medgent is already live on GitHub! Share this link so anyone can download it: https://github.com/medgent/medgent
YOUR GITHUB PAGE WILL LOOK LIKE THIS:
πŸ“ medgent / medgent
⭐ 0 stars   🍴 0 forks   πŸ‘ 1 watching
πŸ“ channels/
telegram_bot.py Β· whatsapp_bot.py
πŸ“ core/
medgent.py
πŸ“ scripts/
install.sh Β· start.sh
πŸ“„ README.md
πŸ“„ requirements.txt
πŸ“„ setup.py
README.md
# πŸ₯ Medgent β€” Personal AI Health Manager
Open Source Β· Free Β· WhatsApp & Telegram Β· Claude AI

Make Medgent Run 24/7

For proactive reminders (morning briefings, medication alerts) to work even when your phone is off, you need a server that runs all the time. Here are the free options.

πŸ’‘
Oracle Cloud is completely FREE forever β€” 4 CPUs and 24GB RAM at zero cost. It's perfect for Medgent. Takes 10 minutes to set up.
1
Choose a Free Server
All of these work. Oracle is the best free option.
ProviderCostHow to get itRating
Oracle CloudFREE forevercloud.oracle.com/free β†’ Create account⭐⭐⭐⭐⭐ Best
Hetzner€3.29/monthhetzner.com β†’ Cloud β†’ Create Server⭐⭐⭐⭐⭐ Best paid
DigitalOcean$4/monthdigitalocean.com β†’ Droplets β†’ Create⭐⭐⭐⭐ Easy
Hostinger VPS$4.99/monthhostinger.com/vps⭐⭐⭐⭐ Good support
Your computerFREEJust leave it running⭐⭐ Not 24/7
2
Connect to Your Server
Use SSH β€” like a remote control for your server.
2

Open a connection to your server

Your VPS provider gives you an IP address (looks like 123.45.67.89). Use it here:

Terminal on YOUR computer
ssh root@YOUR-SERVER-IP
# Example: ssh [email protected]
# Enter the password your VPS provider gave you
# You're now INSIDE your server! πŸŽ‰
πŸ’»
Windows users: Use Windows Terminal or download PuTTY (free) to connect via SSH. Or use the "Console" button on your VPS provider's website β€” no download needed.
3
Install & Start Medgent on the Server
Copy and paste β€” that's literally all you do.
3
πŸš€ One command

Install Medgent on your server

Paste this in your server terminal. It automatically installs everything.

Server Terminal (after SSH)
# Step 1: Install Medgent (downloads everything)
curl -fsSL https://get.medgent.in | bash

# Step 2: Go into the medgent folder
cd medgent

# Step 3: Run setup wizard
python3 setup.py

# Step 4: Start running 24/7
bash scripts/start.sh
🎊
Medgent is now running 24/7! You can close your terminal and your server keeps running. Your morning briefings, medication reminders, and weekly reports will all be delivered automatically β€” even when your phone is off.

How Messages Reach Your Phone

Here's the complete picture of how Medgent works end-to-end.

πŸ‘€ You send
"What should I eat?"
β†’
πŸ’¬ WhatsApp
or Telegram
β†’
πŸ–₯️ Your server
(medgent.py)
β†’
🧠 Claude AI
API call
β†’
πŸ“± Reply arrives
in 3 seconds

Connect Your Messaging App

✈️

Telegram

Easiest option. Free forever. Create a bot with @BotFather in 60 seconds.

  1. Open Telegram β†’ search @BotFather
  2. Send /newbot
  3. Name it My Medgent
  4. Copy the token β†’ paste in setup.py
⭐ Easiest
πŸ’¬

WhatsApp

Needs a free Twilio account. $15 free credit when you sign up.

  1. Create free account at twilio.com
  2. Go to Messaging β†’ WhatsApp Sandbox
  3. Follow the verification steps shown on screen to link your WhatsApp number
  4. Copy SID + Token β†’ paste in setup.py
Popular choice
🌐

Web Browser

No messaging app needed. Just open a URL in your browser.

  1. Run: python channels/web_server.py
  2. Open http://localhost:5050
  3. Chat directly in your browser
No setup

What You Receive Every Day

πŸ₯
Medgent Health Coach
🟒 Online · Always on
πŸŒ… Good morning, Sarah!

πŸ’Š Metformin 500mg at 8AM
πŸ₯— Breakfast: Oats + almond milk
πŸ’§ Goal: 8 glasses of water
πŸ‹οΈ Tip: Walk 20 mins after lunch

βš•οΈ Wellness assistant β€” consult your doctor for medical decisions.
I weighed 79.2kg today
βš–οΈ BMI: 26.1 (Overweight range)
↓ 0.3kg from last week!
Goal: 72kg · Progress: 34% 🎯

Keep it up! πŸ’š

What Does It All Cost?

Complete cost breakdown. Medgent itself is free. These are the only external costs.

Medgent software$0 β€” Free forever
GitHub hosting (your code)$0 β€” Free forever
Oracle Cloud server (24/7)$0 β€” Free forever
Telegram Bot API$0 β€” Free forever
Claude API (typical daily use)~$0.05–0.20/day
Twilio WhatsApp (if used)~$0.005/message
Your TOTAL cost to run Medgent$0 β€” $5/month max
πŸ†“
100% free option: Use Oracle Cloud (free VPS) + Telegram (free bot) + Gemini AI (free tier) = Medgent running 24/7 at zero cost, forever.
πŸ—ΊοΈ Step-by-Step Free Setup Map
1️⃣
cloud.oracle.com/free
Sign up FREE
β†’
2️⃣
Create Ubuntu VM
1 click
β†’
3️⃣
SSH into server
1 terminal cmd
β†’
4️⃣
curl get.medgent.in | bash
Auto installs
β†’
5️⃣
python setup.py
8 questions
β†’
6️⃣
aistudio.google.com
Get free API key
β†’
7️⃣
@BotFather on Telegram
Free bot token
β†’
βœ…
bash start.sh
LIVE 24/7!

Total time: ~15 minutes Β· Total cost: $0 Β· Works forever

Your Complete Setup Checklist

  • Download Medgent ZIP from GitHub
  • Install Python 3.11+
  • Run pip install -r requirements.txt
  • Get a free API key (Claude / Gemini / ChatGPT)
  • Run python setup.py and answer 8 questions
  • Connect Telegram (easiest) or WhatsApp
  • Start Medgent with bash scripts/start.sh
  • Send /start to your bot and get your first message
  • Optional: Upload to GitHub so others can use it
  • Optional: Deploy on free Oracle Cloud server for 24/7 use
πŸŽ‰

You're ready!

Medgent is live. Your AI health manager will send you daily briefings, medication reminders, meal plans, BMI updates, and weekly reports β€” all in WhatsApp or Telegram.

⬇️ Download Medgent Now β€” Free