Skip to content

err0rgod/midanalyzer

Repository files navigation

Midstalker Analyzer

Midstalker Analyzer is a Streamlit-based tool for analyzing [TYPE OF DATA — logs, traces, etc.] and extracting structured insights through a simple interface. It is built with a focus on simplicity, local execution, and ease of use, allowing users to work with their data without relying on heavy cloud infrastructure.

The application can be run locally using Docker for full control and performance, or accessed directly through the hosted Streamlit version.


Why this project

This project was built to avoid limitations of hosted tools such as file size restrictions and slow processing speeds. Running locally ensures better performance and full control over data.

Features

  • Interactive interface built with Streamlit
  • Local file processing without size limitations (Docker mode)
  • Simple and fast setup
  • Minimal dependencies and optimized runtime
  • Clean and modular codebase

Preview

App Screenshot App Screenshot

Getting Started

You can run the project in two ways:

  1. Locally using Docker (recommended)
  2. Using the hosted web version

Running Locally with Docker

Running the application locally removes file size limits and improves performance by using your system resources directly.

Prerequisites

  • Docker installed on your system
  • Git (optional, for cloning the repository)

Quick Start

docker build -t midstalker . docker run -p 8501:8501 midstalker

Steps

Clone the repository:

git clone https://github.com/err0rgod/midstalker_analyzer.git
cd midstalker_analyzer

Build the Docker image:

docker build -t midstalker .

Run the container:

docker run -p 8501:8501 midstalker

Open your browser and go to:

http://localhost:8501

Running via Web (Streamlit)

If you do not want to set up Docker, you can use the hosted version: The hosted version is suitable for quick testing and small inputs. For larger datasets or better performance, local Docker execution is recommended.

https://mid-stalker-analyzer.streamlit.app

Note: The hosted version may have limitations on file size and processing speed.


Project Structure

app.py           main application entry point  
utils/           helper modules  
requirements.txt dependencies  
Dockerfile       container setup  

For more info this project does have a documentation so you can check that out.

Development

To run the project without Docker:

pip install -r requirements.txt
streamlit run app.py

Design Notes

  • The application is designed to run fully locally when needed
  • Docker support ensures consistent environments across systems
  • Non-essential files such as notebooks are excluded from production builds

Contributing

Contributions are welcome. If you find an issue or want to improve the project, feel free to open a pull request or submit an issue.


About the Developer

err0rgod (Nirbhay Katiyar) - Passionate Mechatronics Engineer & Developer practicing secure coding and interconnecting hardware and software.

Focused on secure coding practices. Interests in Electronics , Cybersecurity & Developement. Building Midstalker a MITM framework focuses on enhancing user security and traditional security in Networks.

Connect with err0rgod

License

This project is open-source and available under the MIT License.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors