Initial commit

Author: cfunkz

.gitignore

@@ -0,0 +1,23 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+
+# Virtual environments
+.venv/
+venv/
+
+# Logs
+logs/
+*.log
+
+# Editor / OS
+.vscode/
+.DS_Store
+Thumbs.db
+
+# PyInstaller
+build/
+dist/
+*.spec

README.md

@@ -0,0 +1,179 @@
+# Pythonator
+
+**Pythonator** is a desktop application for running, monitoring, and managing multiple Python scripts concurrently through a clean graphical interface.
+It is designed for developers who want predictable process control, readable logs, and simple environment management without relying on multiple terminal sessions.
+
+At its core, Pythonator is a **local Python process manager with a GUI**.
+
+<p align="left">
+  <img alt="Python" src="https://img.shields.io/badge/Python-3.13%2B-blue" />
+  <img alt="PyQt6" src="https://img.shields.io/badge/UI-PyQt6-41CD52" />
+  <img alt="License" src="https://img.shields.io/badge/License-MIT-black" />
+</p>
+
+---
+
+## Screenshots
+
+<p align="center">
+  <img src="screenshots/image.png" alt="Pythonator – Main window" width="92%">
+</p>
+
+<p align="center">
+  <img src="screenshots/logs.png" alt="Pythonator – Live logs" width="45%">
+  <img src="screenshots/editor.png" alt="Pythonator – Built-in editor" width="45%">
+</p>
+
+<details>
+  <summary><b>Venv setup & log history</b></summary>
+  <br/>
+  <p align="center">
+    <img src="screenshots/history-search.png" alt="History and search mode" width="92%">
+  </p>
+  <p align="center">
+    <img src="screenshots/venv.png" alt="Virtual environment management" width="92%">
+  </p>
+</details>
+
+---
+
+## Capabilities
+
+* ✅ Full ANSI color recognition (256-color, true color, bold, inverse)
+* ✅ Multi-bot process management with isolation
+* ✅ Separate execution paths for UI and processes (`QProcess`, `QThreadPool`)
+* ✅ Live / History / Search log modes
+* ✅ CPU and RAM usage monitoring (via `psutil`)
+* ✅ Virtual environment creation and management
+* ✅ Dependency installation from the UI
+* ✅ Auto-restart on crash (optional)
+* ✅ Integrated Python code editor
+* ✅ Syntax highlighting and line numbers
+* ✅ Jedi-based code completion (optional)
+* ✅ Persistent log storage
+* ✅ Dark theme by default
+
+---
+
+## What it does
+
+* Runs **multiple Python scripts simultaneously**
+* Assigns **one log tab per script**
+* Displays logs exactly as produced by the process (ANSI-accurate)
+* Provides **start / stop / restart** controls per script or globally
+* Supports **custom commands** and script flags
+* Tracks resource usage per process tree
+* Keeps logs on drive for later inspection
+
+---
+
+## Why it exists
+
+Pythonator was built to remove friction commonly encountered during local development:
+
+* switching multiple terminals
+* manually tracking virtual environments
+* restarting crashed scripts
+* inspecting large volumes of console output
+* running long-lived background processes while coding
+
+It is particularly useful for:
+
+* local bots and agents
+* background workers
+* small services
+* development tooling
+* long-running experiments
+
+---
+
+## File structure
+
+| File             | Purpose                                          |
+| ---------------- | ------------------------------------------------ |
+| `app.py`         | Application entry point, palette and theme setup |
+| `config.py`      | Configuration, data models, shared styles        |
+| `console.py`     | ANSI terminal emulator (256-color, true color)   |
+| `log_buffer.py`  | Ring buffer with timestamps and persistence      |
+| `log_view.py`    | Per-bot log viewer (live/history/search)         |
+| `stats.py`       | CPU and RAM monitoring                           |
+| `process_mgr.py` | Process lifecycle and isolation                  |
+| `editor.py`      | Python editor with highlighting and completion   |
+| `main_window.py` | Main application UI                              |
+
+---
+
+## Requirements
+
+* Python **3.13+**
+* `PyQt6` UI framework
+* `psutil` CPU/RAM statistics
+* `jedi` editor autocompletion (optional)
+
+---
+
+Here’s a clean, **non-intimidating but professional** update to the **Running the application** section that covers **Windows executables** and points to a release `.zip`.
+
+You can drop this straight into your README, replacing the existing section.
+
+---
+
+## Running the application
+
+### Option 1: Run from source (any platform)
+
+Requires Python **3.13+**.
+
+```bash
+git clone https://github.com/cfunkz/Pythonator.git
+cd Pythonator
+python app.py
+```
+
+---
+
+### Option 2: Windows executable (no Python required for the app itself)
+
+For Windows users, a prebuilt executable is available.
+
+1. Download the latest release from:
+   **[https://github.com/cfunkz/Pythonator/releases](https://github.com/cfunkz/Pythonator/releases)**
+2. Download the **`.zip`** file for Windows
+3. Extract it
+4. Run `Pythonator.exe`
+
+No Python installation is required **to run the application itself**.
+
+> ⚠️ Note:
+> To run Python scripts *inside* Pythonator, you will still need a Python installation or a configured Python interpreter path.
+> The executable only bundles Pythonator, not a full Python runtime for user scripts.
+
+---
+
+### Platform notes
+
+* **Windows**: Supported via executable (`.exe`)
+* **macOS / Linux**: Run from source (for now)
+* Logs, configs, and virtual environments are stored locally next to the application
+
+No installer is required.
+
+---
+
+## Typical workflow
+
+1. Create a new workspace
+2. Select a Python script (or custom command)
+3. Optionally edit the script using the built-in editor
+4. Optionally configure a custom Python interpreter
+5. Set up a virtual environment
+6. Install dependencies
+7. Start the process
+8. Monitor logs and resource usage
+
+---
+
+## License
+
+MIT License.
+Use it freely, modify it, and build on it.

app.py

@@ -0,0 +1,38 @@
+"""Pythonator - Python Bot Runner."""
+import sys, os
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from PyQt6.QtGui import QIcon, QColor, QPalette
+from PyQt6.QtWidgets import QApplication, QStyleFactory
+from config import STYLE
+from main_window import MainWindow
+
+def dark_palette() -> QPalette:
+    pal = QPalette()
+    dark, darker, light, mid, accent = QColor(24,24,24), QColor(18,18,18), QColor(220,220,220), QColor(35,35,35), QColor(70,130,220)
+    for role, color in [(QPalette.ColorRole.Window, dark), (QPalette.ColorRole.WindowText, light),
+        (QPalette.ColorRole.Base, darker), (QPalette.ColorRole.AlternateBase, dark), (QPalette.ColorRole.Text, light),
+        (QPalette.ColorRole.Button, mid), (QPalette.ColorRole.ButtonText, light),
+        (QPalette.ColorRole.Highlight, accent), (QPalette.ColorRole.HighlightedText, QColor(255,255,255)),
+        (QPalette.ColorRole.ToolTipBase, dark), (QPalette.ColorRole.ToolTipText, light),
+        (QPalette.ColorRole.Link, accent), (QPalette.ColorRole.LinkVisited, QColor(180,130,220)),
+        (QPalette.ColorRole.PlaceholderText, QColor(128,128,128))]:
+        pal.setColor(role, color)
+    return pal
+
+def main() -> int:
+    app = QApplication(sys.argv)
+    app.setStyle(QStyleFactory.create("Fusion"))
+    app.setPalette(dark_palette())
+    font = app.font(); font.setPointSize(10); app.setFont(font)
+    app.setStyleSheet(STYLE)
+    try: app.setWindowIcon(QIcon("icon.ico"))
+    except: pass
+    window = MainWindow()
+    try: window.setWindowIcon(QIcon("icon.ico"))
+    except: pass
+    window.show()
+    return app.exec()
+
+if __name__ == "__main__":
+    sys.exit(main())

config.py

@@ -0,0 +1,67 @@
+"""Configuration, data models, and shared styles."""
+from __future__ import annotations
+import json, re, sys
+from dataclasses import dataclass, asdict
+from pathlib import Path
+
+__version__ = "1.0.0"
+
+# Paths
+def _app_dir() -> Path:
+    return Path(sys.executable if getattr(sys, "frozen", False) else __file__).resolve().parent
+
+APP_DIR = _app_dir()
+CONFIG_FILE = APP_DIR / "bots.json"
+LOGS_DIR = APP_DIR / "logs"
+
+# Tuning
+MAX_LOG_LINES = 50_000
+FLUSH_INTERVAL_MS = 100
+STATS_INTERVAL_MS = 1000
+HISTORY_CHUNK = 5000
+KILL_TIMEOUT_MS = 500
+MAX_FLUSH_CHARS = 50_000
+
+# ANSI
+ANSI_RE = re.compile(r'\x1b\[[0-9;]*[A-Za-z]')
+strip_ansi = lambda t: ANSI_RE.sub('', t)
+normalize = lambda t: t.replace("\x00", "").replace("\r\n", "\n").replace("\r", "\n")
+
+@dataclass
+class Bot:
+    name: str
+    entry: str = ""
+    reqs: str = ""
+    flags: str = ""
+    custom_cmd: bool = False
+    python_path: str = ""
+
+def load_config() -> dict[str, Bot]:
+    if not CONFIG_FILE.exists(): return {}
+    try:
+        data = json.loads(CONFIG_FILE.read_text(encoding="utf-8"))
+        return {n: Bot(**{**{"custom_cmd": False, "python_path": ""}, **c}) for n, c in data.items()}
+    except: return {}
+
+def save_config(bots: dict[str, Bot]) -> None:
+    try: CONFIG_FILE.write_text(json.dumps({n: asdict(b) for n, b in bots.items()}, indent=2), encoding="utf-8")
+    except: pass
+
+# Shared styles
+STYLE = """
+QToolTip { background: #252525; color: #ddd; border: 1px solid #444; padding: 4px; border-radius: 2px; }
+QScrollBar:vertical { background: #1a1a1a; width: 12px; }
+QScrollBar::handle:vertical { background: #404040; min-height: 20px; border-radius: 4px; margin: 2px; }
+QScrollBar::handle:vertical:hover { background: #505050; }
+QScrollBar::add-line:vertical, QScrollBar::sub-line:vertical { height: 0; }
+QScrollBar:horizontal { background: #1a1a1a; height: 12px; }
+QScrollBar::handle:horizontal { background: #404040; min-width: 20px; border-radius: 4px; margin: 2px; }
+QScrollBar::handle:horizontal:hover { background: #505050; }
+QScrollBar::add-line:horizontal, QScrollBar::sub-line:horizontal { width: 0; }
+"""
+BTN = """QPushButton { padding: 4px 10px; border: 1px solid #333; border-radius: 2px; background: #252525; }
+QPushButton:hover { background: #303030; border-color: #444; }
+QPushButton:pressed { background: #202020; }
+QPushButton:disabled { color: #555; background: #1a1a1a; }"""
+INPUT = """QLineEdit, QPlainTextEdit { padding: 4px 8px; border: 1px solid #333; border-radius: 2px; background: #1a1a1a; }
+QLineEdit:focus, QPlainTextEdit:focus { border-color: #4688d8; }"""