🧬 Intelligent dosage tracker application for monitoring supplements, nootropics and psychoactive substances along with their long-term influence on one's mind and body.
Neuronek is an intelligent dosage tracking application designed to monitor and log the use of supplements, nootropics, and psychoactive substances. By recording and analyzing ingestion, it helps users better understand the long-term effects of these compounds on their physical and mental health.
Features offered by application include:
- Ingestion journaling with a set of commands which allows for inserting, updating, retrieving and deleting all the
data stored as
Ingestionmodel.
To install the application, please visit the GitHub Releases Page for pre-built binaries and installation instructions for your platform. Alternatively, you can install the application from supported package managers or build it from source.
Warning
Application is in early stage of development and to avoid polluting package managers with application that can be
potentially dead in few months I do recommend installing from source or using available pre-build binaries.
Application will be available for homebrew, pacman, nix, scoop, dnf and apt when it would be considered
production-ready.
Application can be installed with cargo and providing url to this repository,
this may be the most conformable way for users which are looking for the latest version of application, proceed only if
you have development experience as application might require manual fixes from your side by this release channel.
cargo install --git https://github.com/keinsell/neuronek
Note: This method might be best for users who always want the absolute newest version of the application. However, it may be less stable than the pre-built binaries.
❯ neuronek --helpIngestions are the cornerstone of the Neuronek tracking system, representing each instance when a user consumes a chemical compound. Each ingestion record captures critical pharmacological data: the specific substance consumed, the route of administration, precise dosage, and timestamp of consumption. The application provides a comprehensive yet intuitive command-line interface that enables users to create, retrieve, update, and delete these records with minimal friction. This structured approach to substance tracking allows for detailed analysis of consumption patterns, pharmacokinetics, and subjective effects over time, facilitating improved understanding of how various compounds affect individual physiology and psychology.
Logs the ingestion of a specified substance with the given dosage.
neuronek ingestion log -s caffeine -d 80mg╭──────────────────────────────┬───────────────────────────────────────────╮
│ ID: 1 ┆ — Onset 11:37 → 11:42±5m │
│ Substance: Caffeine ┆ ↑ Comeup 11:42±5m → 11:52±25m │
│ Dosage: 80.0 mg ┆ ≡ Peak 11:52±25m → 12:37±1.2h │
│ Route: Oral ┆ ↓ Comedown 12:37±1.2h → 13:37±2.2h │
│ Ingested: 11:37 10/04/25 ┆ ≈ Afterglow 13:37±2.2h → 17:37±10.2h │
╰──────────────────────────────┴───────────────────────────────────────────╯
Displays detailed information about a specific ingestion identified by its ID.
![WARNING] Ingestion viewing user interface is a subject to change to one that would be compact yet will contain most important information, please share your feedback and expectations in revelant github issues.
neuronek ingestion view <INGESTION_ID>╭──────────────────────────────┬───────────────────────────────────────────╮
│ ID: 1 ┆ — Onset 11:37 → 11:42±5m │
│ Substance: Caffeine ┆ ↑ Comeup 11:42±5m → 11:52±25m │
│ Dosage: 80.0 mg ┆ ≡ Peak 11:52±25m → 12:37±1.2h │
│ Route: Oral ┆ ↓ Comedown 12:37±1.2h → 13:37±2.2h │
│ Ingested: 11:37 10/04/25 ┆ ≈ Afterglow 13:37±2.2h → 17:37±10.2h │
╰──────────────────────────────┴───────────────────────────────────────────╯
Lists all recorded ingestions along with their details such as ID, substance, route of administration, dosage, and ingestion date.
neuronek ingestion list╭────┬───────────┬─────────┬───────┬──────────────────────────────────────╮
│ ID │ Substance │ Dosage │ Route │ Ingested At │
├────┼───────────┼─────────┼───────┼──────────────────────────────────────┤
│ 1 │ Caffeine │ 80.0 mg │ Oral │ 2025-04-10 11:37:30.402524844 +02:00 │
╰────┴───────────┴─────────┴───────┴──────────────────────────────────────╯
Updates the dosage of a specific ingestion identified by its ID.
neuronek ingestion update 1 -d 90mg╭──────────────────────────────┬────────────────────────────────────────╮
│ ID: 1 ┆ No phases recorded for this ingestion. │
│ Substance: Caffeine ┆ │
│ Dosage: 90.0 mg ┆ │
│ Route: Oral ┆ │
│ Ingested: 11:37 10/04/25 ┆ │
╰──────────────────────────────┴────────────────────────────────────────╯
Deletes a specific ingestion identified by its ID from the records.
neuronek ingestion delete 14Ingestion #14 has been successfully deleted.
Application comes with a pre-bundled database of psychoactive substances built on top of PsychonautWiki, such information is easily queryable through CLI and is foundation for further analysis of user's ingestion to provide insight on harm-reduction and predicting subjective effects.
neuronek substance get caffeine╭─────────────┬──────────────────────────────────┬────────────────────────╮
│ Caffeine │
├─────────────┼──────────────────────────────────┼────────────────────────┤
│ Route │ Dosage │ Phases │
├─────────────┼──────────────────────────────────┼────────────────────────┤
│ Insufflated │ (±) Threshold ≤2.50 mg │ — Onset 30s-2m │
│ │ (+) Light 10.0 mg-25.0 mg │ ↑ Comeup 30s-2m │
│ │ (++) Common 25.0 mg-40.0 mg │ ≡ Peak 30m-1h │
│ │ (+++) Strong 40.0 mg-80.0 mg │ ↓ Comedown 6h-10h │
│ │ (++++) Heavy ≥80.0 mg │ ≈ Afterglow 6h-1d │
├─────────────┼──────────────────────────────────┼────────────────────────┤
│ Oral │ (±) Threshold ≤10.0 mg │ — Onset 5m-10m │
│ │ (+) Light 20.0 mg-50.0 mg │ ↑ Comeup 10m-30m │
│ │ (++) Common 50.0 mg-150 mg │ ≡ Peak 45m-1h │
│ │ (+++) Strong 150 mg-500 mg │ ↓ Comedown 1h-2h │
│ │ (++++) Heavy ≥500 mg │ ≈ Afterglow 4h-12h │
╰─────────────┴──────────────────────────────────┴────────────────────────╯
Formulation is a combination of ingredients that are used to create a specific effect. The formulation of a drug can vary depending on the desired effect and the route of administration. Such compositions can be manually created for representation of reccuring ingestion templates.
This command allows you to create a new formulation. You can specify the name, description, and ingredients. Ingredients are added by associating them with specific quantities. This ensures consistent and accurate preparation of the formulation.
neuronek formulation create --name <FORMULATION_NAME> ╭────┬─────────────┬──────────────────────────────────────────────────┬─────────────╮
│ id │ name │ description │ ingredients │
├────┼─────────────┼──────────────────────────────────────────────────┼─────────────┤
│ 1 │ quilla mind │ Mix of everything dedicated to be used everyday. │ {} │
╰────┴─────────────┴──────────────────────────────────────────────────┴─────────────╯
Retrieves details about a specific formulation, including its name, description, and list of ingredients with their respective quantities.
neuronek formulation get <FORMULATION_ID>╭────┬─────────────┬──────────────────────────────────────────────────┬─────────────╮
│ id │ name │ description │ ingredients │
├────┼─────────────┼──────────────────────────────────────────────────┼─────────────┤
│ 1 │ quilla mind │ Mix of everything dedicated to be used everyday. │ {} │
╰────┴─────────────┴──────────────────────────────────────────────────┴─────────────╯
Lists all available formulations along with their IDs, names, and descriptions.
neuronek formulation list╭────┬─────────────┬──────────────────────────────────────────────────┬─────────────╮
│ id │ name │ description │ ingredients │
├────┼─────────────┼──────────────────────────────────────────────────┼─────────────┤
│ 1 │ quilla mind │ Mix of everything dedicated to be used everyday. │ {} │
╰────┴─────────────┴──────────────────────────────────────────────────┴─────────────╯
Modifies an existing formulation. You can update its name, description, or ingredients.
neuronek formulation update 1 --name <FORMULATION_NAME>╭────┬─────────────┬──────────────────────────────────────────────────┬─────────────╮
│ id │ name │ description │ ingredients │
├────┼─────────────┼──────────────────────────────────────────────────┼─────────────┤
│ 1 │ quilla mind │ Mix of everything dedicated to be used everyday. │ {} │
╰────┴─────────────┴──────────────────────────────────────────────────┴─────────────╯
Removes a formulation from the system. Operation itself is destructive and require additional confirmation from user in interactive shell or -y/--no-confirm in non-interactive mode to omit protection against destructive operation.
neuronek formulation delete <FORMULATION_ID>
Formulation deleted successfully
This section describes commands related to managing ingredients within a specific formulation.
Retrieves details about a specific ingredient within a given formulation, including its quantity.
neuronek formulation ingredient rm <INGREDIENT_ID>Lists all ingredients and their quantities associated with a specific formulation.
neuronek formulation ingredient lsAdds a new ingredient to a formulation with a specified quantity.
neuronek formulation ingredient rm <INGREDIENT_ID>Modifies the quantity of an existing ingredient within a formulation.
neuronek formulation ingredient rm <INGREDIENT_ID>Removes an ingredient from a formulation.
neuronek formulation ingredient rm <INGREDIENT_ID>The Project does not expect any external contribution. If you want to contribute, please contact me directly via [email protected], and we can discuss the project together and move code to organization out of my profile.
See CONTRIBUTING.md for more information.
Read the LICENSE file for more information.
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
![@deepsource-autofix[bot]](https://avatars.githubusercontent.com/in/57168?s=64&v=4){kind=small}
![@ellipsis-dev[bot]](https://avatars.githubusercontent.com/in/64358?s=64&v=4){kind=small}
![@codeowners-com[bot]](https://avatars.githubusercontent.com/in/227592?s=64&v=4){kind=small}