kageroumado

kageroumado / piru

Public

iOS substance dose tracker with pharmacokinetic timelines and interaction warnings

ios substance-tracking swift tracker-application
10
0
85% credibility
Found May 25, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

Piru is a substance dose tracker for iPhone that helps people track what they take, when, and in what amount. It overlays pharmacokinetic curves so users can see what's still active in their system, warns about dangerous drug interactions before stacking substances, and provides insights into usage patterns. The app includes a library of over 1,100 substances with dose ranges, routes, durations, and half-lives sourced from trusted harm reduction communities and medical databases. It supports medication adherence tracking for prescriptions and supplements, allows custom substances, and exports data as JSON or PDF reports. Piru is built primarily for harm reduction — helping people make safer, more informed decisions about substance use.

How It Works

1
🔍 You hear about Piru

Someone tells you about an iPhone app that helps you track what you take and shows how long it stays active in your body.

2
📱 You download and open the app

You install Piru on your iPhone and open it for the first time. The app welcomes you and explains what it does.

3
💊 You search for what you took

You type in the substance name and the app finds it instantly from a library of over 1,100 different substances with their dose information.

4
📊 You log your dose and see the timeline

You enter how much you took and how you took it. The app draws a curve showing when it kicks in, peaks, and wears off — so you know what's still active.

5
You add a second substance
✅
Safe combination

The app shows a green checkmark and lets you continue.

🔴
Dangerous interaction

The app shows a red warning explaining the risk so you can make an informed choice.

6
📅 You track your daily medications

If you take prescription medications or supplements, you can set up daily reminders and the app tracks whether you took them.

7
📈 You review your patterns

The Insights tab shows your activity over time — when you use most often, which substances you take together, and your adherence streaks.

🎯 You feel more informed and prepared

You know what's in your system, how long it lasts, and what to avoid mixing. You can share a PDF report with your doctor if needed.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is piru?

Piru is an iOS dose tracker for anyone who takes substances -- recreational, pharmaceutical, or supplement -- and wants to understand what's happening in their body over time. You log what you took, when, and how much; Piru overlays pharmacokinetic curves so you can see when levels are peaking and fading. It also cross-checks new doses against active ones and warns about dangerous interactions before you stack anything. Built in Swift with SwiftUI and SwiftData, it pulls data from TripSit, PsychonautWiki, and FDA databases to cover roughly 1,100 substances with dose ranges, half-lives, and interaction rules.

Why is it gaining traction?

Most dose trackers are glorified journals. Piru actually models what substances do in your system -- a one-compartment PK model estimates absorption curves based on route of administration, so the timeline reflects real pharmacokinetics, not just elapsed time. The interaction checker layers in 59 class-based rules plus TripSit combo data and FDA label warnings, catching combinations like opioid plus benzodiazepine or MAOI plus stimulant before you log them. For iOS 26+ users, Live Activities surface active doses on the Lock Screen and Dynamic Island. It also handles medication adherence separately from the recreational log, so you can track prescription reminders without mixing contexts.

Who should use this?

Harm reduction advocates building tools for their communities will find the interaction database and export features (JSON, PDF reports) useful. Researchers or clinicians who need quick PK reference data might use it as a lookup tool, especially with the half-life calculator. Individual users tracking pharmaceuticals or supplements for adherence purposes could benefit from the separate daily-logging system. This is not a consumer app -- it's for technically inclined people comfortable with beta iOS builds who want data transparency over polished UX.

Verdict

Piru is a serious piece of work: well-structured Swift, 40+ test suites, and a solid pharmacological foundation. At 10 stars and a 0.85% credibility score, it's clearly early-stage and lacks the polish of a production app store release. The iOS 26 requirement limits the audience, and the GPLv3 license means commercial forks are constrained. Worth watching if you need pharmacokinetic modeling and drug interaction checking in a native iOS app, but treat it as a foundation to build on rather than a finished product.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.