2025-03-20 15:33:00
github.com
Minimalytics is a standalone minimalist analytics tool built on SQLite. Designed for resource-constrained environments, it provides a lightweight solution for tracking and visualizing event data with a minimal footprint. Whether you’re tracking internal services or need a simple analytics tool, Minimalytics delivers performance without the bloat.
- Track Events: Record and monitor analytics for various events.
- Web UI: Manage dashboards and visualize event data with interactive graphs.
- Scalable: Supports over a billion events per month with a minimal storage footprint (~20 MB).
- Lightweight: Built with efficiency in mind, ensuring low memory and storage usage.
-
Clone the repository:
git clone https://github.com/nafey/minimalytics.git cd minimalytics
-
Build the project:
go build -o build/minim .
-
Install the binary system-wide:
sudo mv build/minim /usr/local/bin/
-
Check if the server is running:
-
Start the server:
To record an event, send a POST
request to the event API:
curl -X POST http://localhost:3333/api/event/ -H "Content-Type: application/json" -d '{"event": ""}'
Replace
with the name of the event you want to track.
-
Open your browser and navigate to:
-
Go to “First Dashboard” and click “Add Graph”.
-
Select the appropriate properties and click “Done”.
-
Your dashboard is now ready to display event data.
To disable access to the web dashboard, run:
This project was born out of the need for a lightweight analytics tool to track internal services on a resource-constrained VPS. Most SaaS analytics products either lack the scalability or exceed their free tier limits when tracking millions of events per month. Minimalytics addresses this gap by offering a minimalist, high-performance solution for resource-constrained environments.
- Event Aggregation: Minimalytics saves space by aggregating events, storing only aggregate features (e.g., total invocations per day) instead of individual events.
- SQLite Storage: Event data is stored in an SQLite file, initialized during the first run of
minim
. - Server Hosting: The
minim
CLI starts a server that:- Hosts the API endpoint for event submission.
- Serves the web UI (built using minimui and placed in the
static
folder).
- Web UI: Source for the Web UI is available at minimui.
- Support for sum, avg, min, and max on event values.
- Improved UI/UX.
- Multiple metrics in the same graph.
- Additional visualizations: Bar Chart, Pie Chart, etc.
- User ID-based analytics: Funnels, cohorts, and more.
- Details on individual events.
- Hourly event resolution beyond 48 hours.
- Minute resolution beyond 60 minutes.
Contributions are welcome! If you’d like to contribute, please:
- Fork the repository.
- Create a new branch for your feature or bugfix.
- Submit a pull request.
Minimalytics is licensed under the MIT License.
Enjoy using Minimalytics! For questions or feedback, feel free to open an issue on GitHub.
Keep your files stored safely and securely with the SanDisk 2TB Extreme Portable SSD. With over 69,505 ratings and an impressive 4.6 out of 5 stars, this product has been purchased over 8K+ times in the past month. At only $129.99, this Amazon’s Choice product is a must-have for secure file storage.
Help keep private content private with the included password protection featuring 256-bit AES hardware encryption. Order now for just $129.99 on Amazon!
Help Power Techcratic’s Future – Scan To Support
If Techcratic’s content and insights have helped you, consider giving back by supporting the platform with crypto. Every contribution makes a difference, whether it’s for high-quality content, server maintenance, or future updates. Techcratic is constantly evolving, and your support helps drive that progress.
As a solo operator who wears all the hats, creating content, managing the tech, and running the site, your support allows me to stay focused on delivering valuable resources. Your support keeps everything running smoothly and enables me to continue creating the content you love. I’m deeply grateful for your support, it truly means the world to me! Thank you!
BITCOIN bc1qlszw7elx2qahjwvaryh0tkgg8y68enw30gpvge Scan the QR code with your crypto wallet app |
DOGECOIN D64GwvvYQxFXYyan3oQCrmWfidf6T3JpBA Scan the QR code with your crypto wallet app |
ETHEREUM 0xe9BC980DF3d985730dA827996B43E4A62CCBAA7a Scan the QR code with your crypto wallet app |
Please read the Privacy and Security Disclaimer on how Techcratic handles your support.
Disclaimer: As an Amazon Associate, Techcratic may earn from qualifying purchases.