{"id":23679505,"url":"https://github.com/keinsell/neuronek","last_synced_at":"2025-08-18T06:36:29.320Z","repository":{"id":65393875,"uuid":"536805534","full_name":"keinsell/neuronek","owner":"keinsell","description":"🧬 Terminal utility to track, analyze and predict intake of chemical compounds in name of science.","archived":false,"fork":false,"pushed_at":"2025-08-06T16:52:33.000Z","size":382316,"stargazers_count":19,"open_issues_count":43,"forks_count":2,"subscribers_count":1,"default_branch":"trunk","last_synced_at":"2025-08-16T14:55:51.877Z","etag":null,"topics":["command-line","dosage-tracking","linux","macos","psychonautwiki","quantified-self","windows"],"latest_commit_sha":null,"homepage":"https://keinsell.github.io/neuronek/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/keinsell.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-09-15T00:28:37.000Z","updated_at":"2025-08-06T16:52:37.000Z","dependencies_parsed_at":"2024-05-01T19:17:13.646Z","dependency_job_id":"234ac8df-5194-49b2-955c-0fa8a32800c1","html_url":"https://github.com/keinsell/neuronek","commit_stats":null,"previous_names":["keinsell/neuronek-cli","keinsell/neuronek"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/keinsell/neuronek","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keinsell%2Fneuronek","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keinsell%2Fneuronek/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keinsell%2Fneuronek/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keinsell%2Fneuronek/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/keinsell","download_url":"https://codeload.github.com/keinsell/neuronek/tar.gz/refs/heads/trunk","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keinsell%2Fneuronek/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270955568,"owners_count":24674918,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-18T02:00:08.743Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["command-line","dosage-tracking","linux","macos","psychonautwiki","quantified-self","windows"],"created_at":"2024-12-29T17:43:22.705Z","updated_at":"2025-08-18T06:36:29.305Z","avatar_url":"https://github.com/keinsell.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Neuronek\n\n🧬 Intelligent dosage tracker application for monitoring supplements, nootropics and psychoactive substances along with\ntheir long-term influence on one's mind and body.\n\n![preview](docs/assets/log_ingestion_preview.png)\n\n## About\n\nNeuronek is an intelligent dosage tracking application designed to monitor and log the use of supplements, nootropics,\nand\npsychoactive substances. By recording and analyzing ingestion, it helps users better understand the long-term effects\nof these compounds on their physical and mental health.\n\nFeatures offered by application include:\n\n### Features\n\n- **📝 Ingestion Journal**, basic functionality allowing for inserting, updating, retrieving and deleting all the\n  data stored as `Ingestion` model, it's structured way of storing information about substance, time, dosage and route of administration.\n- **🍀 Substance Index**, [`psychonautwiki`](https://psychonautwiki.org)-based index of substances with their dosage information, route of administration and other relevant information.\n\n## Installation\n\nTo install the application, please visit the [GitHub Releases Page](https://github.com/keinsell/neuronek/releases) for\npre-built binaries and installation instructions for your platform. Alternatively, you can install the application from\nsupported package managers or build it from source.\n\n#### Using a package manager (recommended)\n\n\u003e [!WARNING]\n\u003e Application is in early stage of development and to avoid polluting package managers with application that can be\n\u003e potentially dead in few months I do recommend installing from source or using available pre-build binaries.\n\u003e Application will be available for `homebrew`, `pacman`, `nix`, `scoop`, `dnf` and `apt` when it would be considered\n\u003e production-ready.\n\n#### Installation from source (Advanced)\n\nApplication can be installed with `cargo` and providing url to this repository,\nthis may be the most conformable way for users which are looking for the latest version of application, proceed only if\nyou have development experience as application might require manual fixes from your side by this release channel.\n\n```\ncargo install --git https://github.com/keinsell/neuronek\n```\n\n**Note:** This method might be best for users who always want the absolute newest version of the application. However,\nit may be less stable than the pre-built binaries.\n\n#### Installing Shell Autocompletion\n\n```bash\nneuronek completion generate bash \u003e ~/.local/share/bash-completion/completions/neuronek\nneuronek completion generate zsh \u003e ~/.zfunc/_neuronek\nneuronek completion generate fish \u003e ~/.config/fish/completions/neuronek.fish\n```\n\n## Usage\n\n```bash\n❯ neuronek --help\n```\n\n### Ingestion Journaling\n\nIngestions 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.\n\n#### Log Ingestion\n\n_Logs the ingestion of a specified substance with the given dosage._\n\n```bash\nneuronek ingestion log -s caffeine -d 80mg\n```\n\n```present cargo run -- -f pretty ingestion log -s caffeine -d 80mg\n╭──────────────────────────────┬───────────────────────────────────────────╮\n│  ID:         1               ┆  — Onset      11:37       →  11:42±5m     │\n│  Substance:  Caffeine        ┆  ↑ Comeup     11:42±5m    →  11:52±25m    │\n│  Dosage:     80.0 mg         ┆  ≡ Peak       11:52±25m   →  12:37±1.2h   │\n│  Route:      Oral            ┆  ↓ Comedown   12:37±1.2h  →  13:37±2.2h   │\n│  Ingested:   11:37 10/04/25  ┆  ≈ Afterglow  13:37±2.2h  →  17:37±10.2h  │\n╰──────────────────────────────┴───────────────────────────────────────────╯\n```\n\n#### View Ingestion\n\n_Displays detailed information about a specific ingestion identified by its ID._\n\n\u003e ![WARNING]\n\u003e Ingestion viewing user interface is a subject to change to one that would be compact yet will contain most important\n\u003e information, please share your feedback and expectations in revelant github issues.\n\n```bash\nneuronek ingestion view \u003cINGESTION_ID\u003e\n```\n\n```present cargo run -- -f pretty ingestion view 1\n╭──────────────────────────────┬───────────────────────────────────────────╮\n│  ID:         1               ┆  — Onset      11:37       →  11:42±5m     │\n│  Substance:  Caffeine        ┆  ↑ Comeup     11:42±5m    →  11:52±25m    │\n│  Dosage:     80.0 mg         ┆  ≡ Peak       11:52±25m   →  12:37±1.2h   │\n│  Route:      Oral            ┆  ↓ Comedown   12:37±1.2h  →  13:37±2.2h   │\n│  Ingested:   11:37 10/04/25  ┆  ≈ Afterglow  13:37±2.2h  →  17:37±10.2h  │\n╰──────────────────────────────┴───────────────────────────────────────────╯\n```\n\n#### List Ingestions\n\n_Lists all recorded ingestions along with their details such as ID, substance, route of administration, dosage, and\ningestion date._\n\n```bash\nneuronek ingestion list\n```\n\n```present cargo run -- -f pretty ingestion ls\n╭────┬───────────┬─────────┬───────┬──────────────────────────────────────╮\n│ ID │ Substance │ Dosage  │ Route │             Ingested At              │\n├────┼───────────┼─────────┼───────┼──────────────────────────────────────┤\n│ 1  │ Caffeine  │ 80.0 mg │ Oral  │ 2025-04-10 11:37:30.402524844 +02:00 │\n╰────┴───────────┴─────────┴───────┴──────────────────────────────────────╯\n```\n\n#### Update Ingestion\n\n_Updates the dosage of a specific ingestion identified by its ID._\n\n```bash\nneuronek ingestion update 1 -d 90mg\n```\n\n```present cargo run -- -f pretty ingestion update 1 -d 90mg\n╭──────────────────────────────┬────────────────────────────────────────╮\n│  ID:         1               ┆ No phases recorded for this ingestion. │\n│  Substance:  Caffeine        ┆                                        │\n│  Dosage:     90.0 mg         ┆                                        │\n│  Route:      Oral            ┆                                        │\n│  Ingested:   11:37 10/04/25  ┆                                        │\n╰──────────────────────────────┴────────────────────────────────────────╯\n```\n\n#### Delete Ingestion\n\n_Deletes a specific ingestion identified by its ID from the records._\n\n```bash\nneuronek ingestion delete 14\n```\n\n```\nIngestion #14 has been successfully deleted.\n```\n\n### Substances\n\nApplication comes with a pre-bundled database of psychoactive substances built on top\nof [PsychonautWiki](https://psychonautwiki.org), such information is easily queryable through CLI and is foundation\nfor further analysis of user's ingestion to provide insight on harm-reduction and predicting subjective effects.\n\n#### Get Substance\n\n```bash\nneuronek substance get caffeine\n```\n\n```present cargo run -- -f pretty substance get caffeine\n╭─────────────┬──────────────────────────────────┬────────────────────────╮\n│ Caffeine                                                                │\n├─────────────┼──────────────────────────────────┼────────────────────────┤\n│ Route       │ Dosage                           │ Phases                 │\n├─────────────┼──────────────────────────────────┼────────────────────────┤\n│ Insufflated │  (±) Threshold  ≤2.50 mg         │  — Onset      30s-2m   │\n│             │  (+) Light      10.0 mg-25.0 mg  │  ↑ Comeup     30s-2m   │\n│             │  (++) Common    25.0 mg-40.0 mg  │  ≡ Peak       30m-1h   │\n│             │  (+++) Strong   40.0 mg-80.0 mg  │  ↓ Comedown   6h-10h   │\n│             │  (++++) Heavy   ≥80.0 mg         │  ≈ Afterglow  6h-1d    │\n├─────────────┼──────────────────────────────────┼────────────────────────┤\n│ Oral        │  (±) Threshold  ≤10.0 mg         │  — Onset      5m-10m   │\n│             │  (+) Light      20.0 mg-50.0 mg  │  ↑ Comeup     10m-30m  │\n│             │  (++) Common    50.0 mg-150 mg   │  ≡ Peak       45m-1h   │\n│             │  (+++) Strong   150 mg-500 mg    │  ↓ Comedown   1h-2h    │\n│             │  (++++) Heavy   ≥500 mg          │  ≈ Afterglow  4h-12h   │\n╰─────────────┴──────────────────────────────────┴────────────────────────╯\n```\n\n## Contributing\n\nThe Project does not expect any external contribution. If you want to contribute, please contact me directly\nvia [keinsell@protonmail.com,]() and we can discuss the project together and move code to\norganization out of my profile.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for more information.\n\n## License\n\nRead the [LICENSE](LICENSE) file for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeinsell%2Fneuronek","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkeinsell%2Fneuronek","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeinsell%2Fneuronek/lists"}