Parallax

A log collector and AI summarizer.

Use it to manage your service logs and streamline the comprehension of your system or network.

Usage

Clone the directory

git clone https://github.com/kinn-edendev/Parallax.git

Enter the directory

cd Parallax

Run the program

python3 main_window.py

Some dependencies may be missing.

Program Diagram

Below you will find an explaination to the flow of information of this program. Not all features are currently available.

┌────────────────────────┐
│  [Log Reader Service]  │ ◄── Tail log files per service
└────────┬───────────────┘
         ▼
┌────────────────────────┐
│  [Filtering Engine]    │ ◄── Remove noise / non-critical logs
└────────┬───────────────┘
         ▼
┌────────────────────────┐
│  [Summarizer Agent]    │ ◄── "Every 50 logs, summarize this"
│  (Per-service model)   │
└────────┬───────────────┘
         ▼
┌────────────────────────┐
│ [Report Cache/Store]   │ ◄── Store each summary in local DB
└────────┬───────────────┘
         ▼
┌────────────────────────┐
│ [System Aggregator]    │ ◄── Periodically gathers all service reports
│ (Master summarizer)    │     and produces a human-level digest
└────────┬───────────────┘
         ▼
┌────────────────────────────┐
│ [System-Wide Report Output]│ ◄── CLI / JSON / HTML / Slack, etc.
└────────────────────────────┘

Program Directory

An brief explaination to the scripts of this program. Some files are user-provided.

Parallax/
├── main_window.py       # GUI entrypoint
├── main.py              # CLI entrypoint
├── config.toml          # Config file (user-provided)
├── config.py            # Config parser
├── config_editor.py     # GUI Config editor library
├── run_editor.py        # GUI Config editor entrypoint
├── collector.py         # Log watching & batch builder
├── runtime_state.py     # Collects immediate log data
├── filter.py            # Filtering logic
├── storage.py           # DB interface (SQLite)
├── logs.db              # Database (user-provided)
├── model.py             # Prompt formatting / LLM call stub