gitwtfhub

wtf is artemisia?

marelucent/artemisia — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

TL;DR

A private, self-hosted menstrual cycle tracker that stores all your data in one file, with no accounts, cloud, or ads.

Mindmap

mindmap
  root((Artemisia))
    What it does
      Menstrual cycle tracker
      One file self hosted
      No accounts or cloud
      Honest period predictions
    Tech stack
      Python
      SQLite
    Use cases
      Private daily logging
      Import Clue export
      Cycle statistics
    Audience
      Privacy focused users
      Non-technical beginners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Track your menstrual cycle, symptoms, mood, and energy privately with no account or cloud service.

REASON 2

Get an honest predicted date range for your next period based on your own cycle history.

REASON 3

Import your existing data from a Clue app export without losing anything.

REASON 4

See statistical patterns in your own cycle data, including symptom clustering and long term variability.

What's in the stack?

PythonSQLite

How it stacks up

marelucent/artemisia0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires installing Python and running the app from a terminal, the README includes a beginner friendly step by step guide.

Free to use, modify, and rename for your own purposes under the MIT license.

Wtf does this do

Artemisia is a private, self-hosted app for tracking your menstrual cycle. All of your data is stored in a single file on your own computer, using SQLite, a lightweight database format. There are no user accounts to create, no cloud servers involved, no advertising, and no subscription fee. The whole application is one Python file that you run yourself. The app lets you log your period flow, symptoms, mood, energy level, discharge, and personal notes for each day directly on a calendar, which also marks the real phase of the moon and shows which day of your cycle you are on. It predicts your next period as a range of likely dates based on your own past cycles, rather than a single falsely precise date, and it gives similarly labeled estimates for your fertile window and ovulation. A year view lets you see twelve months at once so long term patterns become visible. An insights section shows how your cycle length has changed over time and how often certain symptoms and moods occur. A statistics section, called the Almanac, calculates which symptoms tend to cluster in which phase of your cycle, tests whether your own cycles line up with the lunar cycle, and tracks rolling variability that can flag early signs of perimenopause. If you already track your cycle in the Clue app, Artemisia can import your full data export from Clue without losing or duplicating anything. You can also export everything as a CSV file or download the raw database file as a backup at any time. The app can be installed on a phone as a standalone app if you set up HTTPS access to your own server, for example using the free tool Tailscale. Running it requires installing Python on your own computer, installing a few dependencies with pip, and starting the app with a single command, after which you access it through a web browser at a local address. The README includes a full step by step guide aimed at people who have never used Python or a terminal before. The project is released under the MIT license and it explicitly states that none of its predictions are medical advice.

Yoink these prompts

Prompt 1
Help me install Python and get Artemisia running on my own computer for the first time.
Prompt 2
Explain how to import my Clue data export into Artemisia.
Prompt 3
Show me how to set up Artemisia as an installable app on my phone using Tailscale.
Prompt 4
Walk me through backing up my Artemisia data file.

Frequently asked questions

wtf is artemisia?

A private, self-hosted menstrual cycle tracker that stores all your data in one file, with no accounts, cloud, or ads.

What language is artemisia written in?

Mainly Python. The stack also includes Python, SQLite.

What license does artemisia use?

Free to use, modify, and rename for your own purposes under the MIT license.

How hard is artemisia to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is artemisia for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.