🧬 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.
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.
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.
After installation, you can start using the application by running the psylog command in your terminal. The
application provides a command-line interface (CLI) for interacting with its features and functionalities.
❯ neuronek --helpIngestions are fundamental area of application, they represent human interaction with chemical compound of choice. Ingestion explains what compound was ingested, how it was ingested and when it was ingested.
❯ neuronek ingestion log caffeine 80mg
+----+----------------+--------+----------------------+-------------------------------+
| id | substance_name | route | dosage | ingested_at |
+----+----------------+--------+----------------------+-------------------------------+
| 1 | caffeine | "oral" | 80 mg | 2024-12-16 00:02:48.977457 |
+----+----------------+--------+----------------------+-------------------------------+❯ neuronek ingestion list
+----+----------------+---------------+----------------------+----------------------------+
| id | substance_name | route | dosage | ingested_at |
+----+----------------+---------------+----------------------+----------------------------+
| 36 | caffeine | "oral" | 80 mg | 2024-12-18 08:14:37.211076 |
+----+----------------+---------------+----------------------+----------------------------+❯ neuronek ingestion list
+----+----------------+---------------+----------------------+----------------------------+
| id | substance_name | route | dosage | ingested_at |
+----+----------------+---------------+----------------------+----------------------------+
| 36 | caffeine | "oral" | 80 mg | 2024-12-18 08:14:37.211076 |
+----+----------------+---------------+----------------------+----------------------------+
❯ neuronek ingestion update 36 -d 200mg
+----+----------------+---------------+----------------------+----------------------------+
| id | substance_name | route | dosage | ingested_at |
+----+----------------+---------------+----------------------+----------------------------+
| 36 | caffeine | "oral" | 200 mg | 2024-12-18 08:14:37.211076 |
+----+----------------+---------------+----------------------+----------------------------+Caution
Deletion cannot be undone, so verify the correct ID before deleting.
❯ neuronek ingestion list
+----+----------------+--------+----------+----------------------------+
| id | substance_name | route | dosage | ingested_at |
+----+----------------+--------+----------+----------------------------+
| 36 | caffeine | "oral" | 80 mg | 2024-12-18 08:14:37.211076 |
+----+----------------+--------+----------+----------------------------+
❯ neuronek ingestion delete 36Application comes with pre-bundled database of psychoactive substances built on top of PsychonautWiki, such information are easily queryable through CLI and are foundation for further analysis of user's ingestions to provide insight on harm-reduction and predicting subjective effects.
TODO: Feature should use humanized search index which will allow for typos and words with same meaning (common names).
TODO: Show all information about substance in way ingest-able for end-user which should be able to learn dosages, routes of administration and maybe overall description of substance.
Journal is a feature which aims to compose ingestion-related and substance-related features of application into friendly human interface.
- Usecase: Logging ingestions of capsules and pills which may contain multiple substances.
- Usecase: Ingestion planning when it's possible - users should be informed how long it takes for substance to get into body and how long it will last.
Roadmap is a subject to change and one that is presented here is a high-level overview of direction of the project.
neuronek is an ongoing project with many planned features and improvements. Some of the key areas of development include:
- Journaling: A user-friendly interface for creating and managing journal entries related to ingestions, thoughts, and experiences.
- Terminal User Interface: Friendly and efficient interactive interface for terminal application.
- Web Application
- Desktop/Mobile Application
- Cloud Sync
Project do 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.