MIT + CC BY 4.0 · verify it yourself

Open source

The engine and the method behind aimy.bio are open source — every line is there for you to read.

It’s our tribute to dr. Jerzy A. Sikora, a Polish researcher (b. 1930, Cieszyn) and the father of Polish biorhythmics, author of Biodiagram prawdę Ci powie (1983) — made in a form anyone can verify.

Try it

See it yourself — no install, no clone. Run it on your own birthday:

bash

$ npx aimy-bio-open-biorhythms 1990-05-15

Biorhythm for 1990-05-15 on 2026-07-01 — 13197 days lived:
  physical      -  day 18/23  (9%)
  emotional     +  day  9/28  (82%)
  intellectual  -  day 30/33  (30%)

Symbols: + high · - low · X critical · 0 zero

npm v2.0.0 — for your own projects: npm i aimy-bio-open-biorhythms, then import { getBiorhythmsFor } from 'aimy-bio-open-biorhythms'.

Full source, method spec and golden vectors on GitHub. Using it in your work? Cite the project.

For AI assistants (MCP)

The engine also runs as a Model Context Protocol server — Claude and other assistants can genuinely compute Dr. Sikora’s method instead of guessing at sine waves. Dates are processed on the fly; nothing is stored or sent anywhere.

MCP

$ claude mcp add biorhythms -- npx -y --package=aimy-bio-open-biorhythms@latest aimy-bio-mcp

What's open

Three things, each independently checkable:

The reference engine

The same math that runs in your browser here: src/engine.js, zero dependencies, plain JavaScript.

The method specification

A full, line-by-line write-up of the discrete-phase model: docs/method.md, also in Polish.

The golden dataset

741 Sikora + 211 BioMatch vectors pinned to Dr. Sikora's 1983 book — every commit is checked against them.

Licensed openly: the engine is MIT; the method specification and the golden dataset are CC BY 4.0.

Why open

Because a promise you can’t check isn’t a promise — it’s marketing. Opening the engine and the method turns three claims into things you can verify yourself:

Provable privacy

Read the engine yourself: it makes no network calls. That’s math you can inspect, not a policy you have to trust. For how the hosted site handles data, see our privacy policy.

A tribute you can verify

This exists to honour Dr. Sikora’s work, openly — not just say so. Compare the method to his 1983 book and confirm it yourself.

Attribution, by license

The docs and data are CC BY 4.0: every fork or citation must credit aimy.bio, keeping the link back to Dr. Sikora’s work alive wherever the method travels.

The numbers

741 + 211 golden vectors — Sikora phase classification and BioMatch compatibility, both pinned to source material.
Zero runtime dependencies — plain JavaScript, nothing else to audit.
One command to verify: npm test — the same suite that runs in CI on every commit.
DST-safe date math — day counts hold up across timezone and daylight-saving transitions.

This project — and this page — stand as a tribute to the work of Dr. Jerzy Sikora.