Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

addonol/python-ram-flow

Repository files navigation

PYTHON-RAM-FLOW 🌊

A high-precision, real-time memory flow tracker and stress-tester for Python.

Stop guessing why your workers are crashing. Start auditing your memory lifecycle.


Why RAM-FLOW?

The "Monolith" Challenge

In modern Python development, projects tend to grow rapidly. What starts as a simple script often evolves into a massive Django or FastAPI monolith with dozens of applications, heavy ORM signals, and complex middleware.

In these environments, it is incredibly easy to accidentally explode host resources. A forgotten global cache, an unfiltered database cursor, or a heavy model loaded into memory creates what we call "Silent Bloat". While your script might seem to run fine once, it leaves behind a residual footprint.

In long-running worker environments (Celery, RQ), these small leaks accumulate until they trigger a catastrophic Out-Of-Memory (OOM) crash, potentially taking down your entire host. RAM-FLOW was built to detect these breakers before they reach production, giving you a surgical view of the memory lifecycle.

πŸš€ Quick Start

Installation

pip install python-ram-flow

Integrated Usage

from ramflow import tracker
# 1. Capture infrastructure load (Django models, apps, etc.)
tracker.log_django_bootstrap()
@tracker.track("Oracle Data Extraction")
def process_data():
 # Your heavy logic here
 # RAM-FLOW monitors the 'Net Self' impact of this specific call
 pass
# 2. Run and Generate the Platinum Dashboard
process_data()
tracker.generate_report(suffix="nightly_sync")

πŸ“Š Visual Insights

RAM-FLOW Dashboard

About

A high-precision memory flow auditor and stress-tester for Python. Monitor RAM consumption per function call with premium HTML dashboards, visual audit trails, and safety circuit breakers.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /