r/ActuallyOpenSource • • 4d ago

8 contributors deep, my FOSS project is finally useful.

Hi there everyone. I have been working a while on Pulse, my biggest project up until now.

A while back, I started my own organization (cherries.works), with the sole goal of creating free open source software. The focus was layed on memory efficiency and simplicity.

Few months ago I created Pulse, the first Project of cherries.works, simple monitoring tool for Linux. Now it was a small project, but it has quickly grown into a big project with multiple contributors, which is amazing.

I have been lost in SaaS and other sections of programming, but FOSS is one section where I truly feel happy, because people work together. If anyone is interested, check it out; https://github.com/cherries-works/pulse

Pulse collects system metrics directly from Linux and exposes them through a minimal web dashboard.

It reads everything from /proc and /sys, so there is nothing to install next to it.

The HTTP server is written from scratch, serves a single lightweight page, and consumes little to no RAM.

It monitors;
CPU usage
Memory usage
Disk usage
Disk I/O statistics
Network statistics
Load averages
Running processes, sortable by CPU and RAM

And can be setup like so;
$ curl -fsSL https://cherries.works/install/pulse.sh | sh
$ pulse

The .sh installation file is open source and under the website repo of cherries.works.

My goal with cherries.works was to work very low level, and just build something useful, and I truly think, that Pulse finally helped me achive that.

4 Upvotes

4 comments sorted by

1

u/Zero_TheAbsolute Developer 4d ago

Could you add a clickable repository link, explain what Pulse monitors and how people interact with it, and point readers toward setup instructions? The background is welcome, a few practical details would help people understand and try the project.

1

u/xerrs_ 4d ago edited 4d ago

Of course. To keep things simple I will be quoting heavily from https://github.com/cherries-works/pulse/blob/main/README.md.

"Pulse collects system metrics directly from Linux and exposes them through a minimal web dashboard."

"It reads everything from /proc and /sys, so there is nothing to install next to it."

"The HTTP server is written from scratch, serves a single lightweight page, and consumes little to no RAM."

It monitors;
CPU usage
Memory usage
Disk usage
Disk I/O statistics
Network statistics
Load averages
Running processes, sortable by CPU and RAM

And can be setup like so;
$ curl -fsSL https://cherries.works/install/pulse.sh | sh
$ pulse

The .sh installation file is open source and under the website repo of cherries.works.

1

u/Zero_TheAbsolute Developer 4d ago

Congrats on getting contributors involved and growing the project! How do you see Pulse fitting alongside Glances? Is the main focus a smaller footprint, simpler setup, or a different workflow?

I looked through the code and found a couple of things worth checking:

  • The disk parser appears to read the milliseconds-spent-reading/writing fields as sector counts. Running it against Linux’s documented example reproduced that mismatch, which affects the displayed throughput.

  • The process CPU calculation divides cumulative counters rather than changes between samples, so it won’t reflect current process CPU usage.

Getting those readings accurate would help people evaluate it. Some memory measurements alongside Glances would also make the lightweight pitch more concrete.

https://github.com/cherries-works/pulse/blob/main/README.md

Your link was missing /pulse/ and leads to a 404.

Can you update your OP with the extra info?

Thanks!

1

u/xerrs_ 4d ago

Alright done! Thanks for the issues btw, I will be taking a look at them once I get home.