dockerbrain 1.0__tar.gz → 1.0.2__tar.gz

dockerbrain-1.0.2/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: dockerbrain
+Version: 1.0.2
+Summary: AI-powered Docker container monitoring, analysis, and optimization CLI.
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/iamPulakesh/DockerBrain
+Project-URL: Repository, https://github.com/iamPulakesh/DockerBrain
+Project-URL: Issues, https://github.com/iamPulakesh/DockerBrain/issues
+Keywords: docker,containers,monitoring,optimization,gemini,ai,devops,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: docker>=6.0
+Requires-Dist: google-genai>=1.0
+Requires-Dist: openai>=1.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Dynamic: license-file
+
+# Project Info
+
+[![pipeline](https://github.com/iamPulakesh/DockerBrain/actions/workflows/dockerbrain.yml/badge.svg)](https://github.com/iamPulakesh/DockerBrain/actions/workflows/dockerbrain.yml) [![github project](https://img.shields.io/badge/github-project-blue.svg?logo=github)](https://github.com/iamPulakesh/DockerBrain)
+
+## Core components of DockerBrain
+
+This package contains the command-line based program that allows you to monitor your Docker containers in real time, detect resource issues, and use LLMs to generate actionable optimizations for running containers and Dockerfiles right from your terminal.
+
+## Installation
+
+Complete DockerBrain's setup by installing the package via pip. To install this package, run:
+
+**Recommended**:
+
+```bash
+uv tool install dockerbrain
+```
+
+**Or with pip:**
+
+```bash
+pip install dockerbrain
+```
+
+## Contact
+
+For bug reports or feature requests, please open an issue on [GitHub](https://github.com/iamPulakesh/DockerBrain/issues)

dockerbrain-1.0.2/PYPI_README.md

@@ -0,0 +1,27 @@
+# Project Info
+
+[![pipeline](https://github.com/iamPulakesh/DockerBrain/actions/workflows/dockerbrain.yml/badge.svg)](https://github.com/iamPulakesh/DockerBrain/actions/workflows/dockerbrain.yml) [![github project](https://img.shields.io/badge/github-project-blue.svg?logo=github)](https://github.com/iamPulakesh/DockerBrain)
+
+## Core components of DockerBrain
+
+This package contains the command-line based program that allows you to monitor your Docker containers in real time, detect resource issues, and use LLMs to generate actionable optimizations for running containers and Dockerfiles right from your terminal.
+
+## Installation
+
+Complete DockerBrain's setup by installing the package via pip. To install this package, run:
+
+**Recommended**:
+
+```bash
+uv tool install dockerbrain
+```
+
+**Or with pip:**
+
+```bash
+pip install dockerbrain
+```
+
+## Contact
+
+For bug reports or feature requests, please open an issue on [GitHub](https://github.com/iamPulakesh/DockerBrain/issues)

{dockerbrain-1.0 → dockerbrain-1.0.2}/README.md

@@ -23,10 +23,31 @@ DockerBrain monitors your Docker containers in real time, detects resource issue
 
 ---
 
+## Usage
+
+DockerBrain exposes all functionality through the `dockerb` CLI. Run the following to see all available commands and options:
+
+```bash
+dockerb --help
+```
+
+Each command also has its own help page, for example `dockerb suggest --help`, `dockerb fix --help`, etc.
+
+---
+
+
 ## Installation
 
 **Requirements:** Python 3.10+ and a running Docker daemon.
 
+**Recommended**:
+
+```bash
+uv tool install dockerbrain
+```
+
+**Or with pip:**
+
 ```bash
 pip install dockerbrain
 ```
@@ -43,12 +64,12 @@ dockerb --version
 dockerb init
 ```
 
-This creates `.dockerbrainrc` in your project directory. Open it and set your provider and key:
+This creates `.dockerbrainrc` in `~/.dockerbrain/`. Open it with `dockerb config` and set your key:
 
 ```ini
 [llm]
-provider = "gemini"
-model    = "gemini-3.1-flash-lite-preview"
+provider = "groq"
+model    = "openai/gpt-oss-120b"
 api_key  = "your_key_here"
 ```
 
@@ -62,18 +83,6 @@ api_key  = "your_key_here"
 
 ---
 
-## Usage
-
-DockerBrain exposes all functionality through the `dockerb` CLI. Run the following to see all available commands and options:
-
-```bash
-dockerb --help
-```
-
-Each command also has its own help page, for example `dockerb suggest --help`, `dockerb fix --help`, etc.
-
----
-
 ## Pre-commit Hook
 
 DockerBrain can run as a [pre-commit](https://pre-commit.com/) hook to lint Dockerfiles on every commit:

dockerbrain-1.0.2/core/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.2"

{dockerbrain-1.0 → dockerbrain-1.0.2}/core/cli.py

@@ -237,7 +237,7 @@ README.md
 
 @cli.command()
 def init() -> None:
-    """Create a .dockerbrainrc config file in the current directory.
+    """Create a .dockerbrainrc config file in ~/.dockerbrain/.
 
     Creates a TOML config with defaults for monitoring thresholds,
     LLM model selection, and other settings. Edit it as per your requirements.
@@ -247,7 +247,9 @@ def init() -> None:
     from rich.console import Console
 
     console = Console()
-    config_path = Path(".dockerbrainrc")
+    config_dir = Path.home() / ".dockerbrain"
+    config_dir.mkdir(parents=True, exist_ok=True)
+    config_path = config_dir / ".dockerbrainrc"
 
     if config_path.exists():
         console.print(f"[yellow] {config_path} already exists.[/]")
@@ -258,7 +260,7 @@ def init() -> None:
 
 # LLM Provider & Models, To switch provider or model, edit below.
 
-# GEMINI (Overall Best)
+# GEMINI
 #   provider = "gemini"
 #   model = "gemini-3.1-flash-lite-preview", "gemini-flash-latest"
 
@@ -272,8 +274,8 @@ def init() -> None:
 #   base_url = "http://localhost:11434/v1"   # change if not default
 
 [llm]
-provider = "gemini"
-model    = "gemini-3.1-flash-lite-preview"
+provider = "groq"
+model    = "openai/gpt-oss-120b"
 api_key  = ""              # Paste your LLM API key here
 # base_url = ""            # Only for Ollama
 
@@ -295,6 +297,32 @@ check_dockerignore    = true  # Warn if .dockerignore is missing
     config_path.write_text(config_content, encoding="utf-8")
     console.print(f"[green]Created [bold]{config_path}[/bold][/]")
 
+@cli.command()
+def config() -> None:
+    """Open the .dockerbrainrc config file in your default editor."""
+    import subprocess
+    import sys
+    from pathlib import Path
+
+    from rich.console import Console
+
+    console = Console()
+    config_path = Path.home() / ".dockerbrain" / ".dockerbrainrc"
+
+    if not config_path.exists():
+        console.print(
+            "[yellow]Config not found.[/] Run [cyan]dockerb init[/] first."
+        )
+        return
+
+    if sys.platform == "win32":
+        subprocess.run(["notepad", str(config_path)])
+    elif sys.platform == "darwin":
+        subprocess.run(["open", str(config_path)])
+    else:
+        editor = __import__("os").environ.get("EDITOR", "nano")
+        subprocess.run([editor, str(config_path)])
+
 @cli.command()
 def env() -> None:
     """Check your environment and configs."""
@@ -340,7 +368,7 @@ def env() -> None:
         masked = cfg.api_key[:4] + "…" + cfg.api_key[-4:] if len(cfg.api_key) > 8 else "set ✓"
         _ok("API Key", f"{masked}")
     except SystemExit:
-        _fail("API Key", "not set in .dockerbrainrc")
+        _fail("API Key", "not set in ~/.dockerbrain/.dockerbrainrc")
 
     db_path = Path.home() / ".dockerbrain" / "metrics.db"
     if db_path.exists():

{dockerbrain-1.0 → dockerbrain-1.0.2}/core/llm.py

@@ -36,8 +36,8 @@ class LLMConfig:
 
 
 def _read_rc_section(section: str = "llm") -> dict[str, str]:
-    """Read a section from .dockerbrainrc (simple TOML-like INI parser)."""
-    rc_path = Path(".dockerbrainrc")
+    """Read a section from ~/.dockerbrain/.dockerbrainrc (simple TOML-like INI parser)."""
+    rc_path = Path.home() / ".dockerbrain" / ".dockerbrainrc"
     if not rc_path.exists():
         return {}
 
@@ -96,7 +96,7 @@ def _show_missing_key_error(provider: str) -> None:
     """Show a brief error for missing API key."""
     console.print(
         Panel(
-            f"Add your key to [cyan].dockerbrainrc[/]:\n"
+            f"Add your key to [cyan]~/.dockerbrain/.dockerbrainrc[/]:\n"
             f'  [cyan]api_key = "your_key_here"[/]',
             title="[bold red]Missing API Key[/]",
             border_style="red",

dockerbrain-1.0.2/dockerbrain.egg-info/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: dockerbrain
+Version: 1.0.2
+Summary: AI-powered Docker container monitoring, analysis, and optimization CLI.
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/iamPulakesh/DockerBrain
+Project-URL: Repository, https://github.com/iamPulakesh/DockerBrain
+Project-URL: Issues, https://github.com/iamPulakesh/DockerBrain/issues
+Keywords: docker,containers,monitoring,optimization,gemini,ai,devops,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: docker>=6.0
+Requires-Dist: google-genai>=1.0
+Requires-Dist: openai>=1.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Dynamic: license-file
+
+# Project Info
+
+[![pipeline](https://github.com/iamPulakesh/DockerBrain/actions/workflows/dockerbrain.yml/badge.svg)](https://github.com/iamPulakesh/DockerBrain/actions/workflows/dockerbrain.yml) [![github project](https://img.shields.io/badge/github-project-blue.svg?logo=github)](https://github.com/iamPulakesh/DockerBrain)
+
+## Core components of DockerBrain
+
+This package contains the command-line based program that allows you to monitor your Docker containers in real time, detect resource issues, and use LLMs to generate actionable optimizations for running containers and Dockerfiles right from your terminal.
+
+## Installation
+
+Complete DockerBrain's setup by installing the package via pip. To install this package, run:
+
+**Recommended**:
+
+```bash
+uv tool install dockerbrain
+```
+
+**Or with pip:**
+
+```bash
+pip install dockerbrain
+```
+
+## Contact
+
+For bug reports or feature requests, please open an issue on [GitHub](https://github.com/iamPulakesh/DockerBrain/issues)

{dockerbrain-1.0 → dockerbrain-1.0.2}/dockerbrain.egg-info/SOURCES.txt

@@ -1,4 +1,5 @@
 LICENSE
+PYPI_README.md
 README.md
 pyproject.toml
 core/__init__.py

{dockerbrain-1.0 → dockerbrain-1.0.2}/pyproject.toml

@@ -4,9 +4,9 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dockerbrain"
-version = "1.0"
+version = "1.0.2"
 description = "AI-powered Docker container monitoring, analysis, and optimization CLI."
-readme = "README.md"
+readme = "PYPI_README.md"
 requires-python = ">=3.10"
 license = {text = "Apache-2.0"}
 keywords = ["docker", "containers", "monitoring", "optimization", "gemini", "ai", "devops", "cli"]

{dockerbrain-1.0 → dockerbrain-1.0.2}/setup.cfg

@@ -1,4 +1,4 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-
+[egg_info]
+tag_build = 
+tag_date = 0
+

dockerbrain-1.0/PKG-INFO

@@ -1,156 +0,0 @@
-Metadata-Version: 2.4
-Name: dockerbrain
-Version: 1.0
-Summary: AI-powered Docker container monitoring, analysis, and optimization CLI.
-License: Apache-2.0
-Project-URL: Homepage, https://github.com/iamPulakesh/DockerBrain
-Project-URL: Repository, https://github.com/iamPulakesh/DockerBrain
-Project-URL: Issues, https://github.com/iamPulakesh/DockerBrain/issues
-Keywords: docker,containers,monitoring,optimization,gemini,ai,devops,cli
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: System :: Monitoring
-Classifier: Topic :: System :: Systems Administration
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: click>=8.0
-Requires-Dist: docker>=6.0
-Requires-Dist: google-genai>=1.0
-Requires-Dist: openai>=1.0
-Requires-Dist: rich>=13.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0; extra == "dev"
-Dynamic: license-file
-
-# DockerBrain
-
-**AI-powered Docker container monitoring, optimization, and Dockerfile generation CLI.**
-
-[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
-[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-green.svg)](LICENSE)
-[![PyPI](https://img.shields.io/pypi/v/dockerbrain)](https://pypi.org/project/dockerbrain/)
-
-DockerBrain monitors your Docker containers in real time, detects resource issues, and uses LLMs to generate actionable optimizations for running containers and Dockerfiles. Supports **Gemini**, **Groq**, and **Ollama**. All configuration lives in a single `.dockerbrainrc` file.
-
----
-
-## Features
-
-| Feature | Command | LLM Required |
-|---|---|:---:|
-| Real-time container monitoring | `dockerb monitor` | No |
-| AI optimization suggestions | `dockerb suggest` | Yes |
-| Auto-fix containers & Dockerfiles | `dockerb fix` | Yes |
-| AI Dockerfile generation from project | `dockerb dockerize` | Yes |
-| Curated Dockerfile templates | `dockerb template` | No |
-| Environment & config diagnostics | `dockerb env` | No |
-
----
-
-## Installation
-
-**Requirements:** Python 3.10+ and a running Docker daemon.
-
-```bash
-pip install dockerbrain
-```
-
-Verify:
-
-```bash
-dockerb --version
-```
-
-### Configure an LLM Provider
-
-```bash
-dockerb init
-```
-
-This creates `.dockerbrainrc` in your project directory. Open it and set your provider and key:
-
-```ini
-[llm]
-provider = "gemini"
-model    = "gemini-3.1-flash-lite-preview"
-api_key  = "your_key_here"
-```
-
-| Provider | API Key | Link |
-|---|:---:|---|
-| Gemini | Required | [aistudio.google.com](https://aistudio.google.com/app/apikey) |
-| Groq | Required | [console.groq.com/keys](https://console.groq.com/keys) |
-| Ollama | Not Required | [ollama.com](https://ollama.com) |
-
-> `monitor`, `template`, and `env` commands work without an API key.
-
----
-
-## Usage
-
-DockerBrain exposes all functionality through the `dockerb` CLI. Run the following to see all available commands and options:
-
-```bash
-dockerb --help
-```
-
-Each command also has its own help page, for example `dockerb suggest --help`, `dockerb fix --help`, etc.
-
----
-
-## Pre-commit Hook
-
-DockerBrain can run as a [pre-commit](https://pre-commit.com/) hook to lint Dockerfiles on every commit:
-
-```yaml
-# .pre-commit-config.yaml 
-repos:
-  - repo: https://github.com/iamPulakesh/DockerBrain
-    rev: v1.0
-    hooks:
-      - id: dockerbrain-fix
-```
-
----
-
-## Development
-
-```bash
-git clone https://github.com/iamPulakesh/DockerBrain.git
-cd DockerBrain
-pip install -e ".[dev]"
-
-make test                              
-make lint                              
-make clean                    
-```
-
----
-
-See [Changelog.md](Changelog.md) for the full release history.
-
----
-
-## Contributing
-
-1. Fork the repository
-2. Contribute
-3. Open a Pull Request
-
----
-
-## License
-
-Apache-2.0 — see [LICENSE](LICENSE) for details.

dockerbrain-1.0/core/__init__.py

@@ -1 +0,0 @@
-__version__ = "1.0"

dockerbrain-1.0/dockerbrain.egg-info/PKG-INFO

@@ -1,156 +0,0 @@
-Metadata-Version: 2.4
-Name: dockerbrain
-Version: 1.0
-Summary: AI-powered Docker container monitoring, analysis, and optimization CLI.
-License: Apache-2.0
-Project-URL: Homepage, https://github.com/iamPulakesh/DockerBrain
-Project-URL: Repository, https://github.com/iamPulakesh/DockerBrain
-Project-URL: Issues, https://github.com/iamPulakesh/DockerBrain/issues
-Keywords: docker,containers,monitoring,optimization,gemini,ai,devops,cli
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: System :: Monitoring
-Classifier: Topic :: System :: Systems Administration
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: click>=8.0
-Requires-Dist: docker>=6.0
-Requires-Dist: google-genai>=1.0
-Requires-Dist: openai>=1.0
-Requires-Dist: rich>=13.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0; extra == "dev"
-Dynamic: license-file
-
-# DockerBrain
-
-**AI-powered Docker container monitoring, optimization, and Dockerfile generation CLI.**
-
-[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
-[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-green.svg)](LICENSE)
-[![PyPI](https://img.shields.io/pypi/v/dockerbrain)](https://pypi.org/project/dockerbrain/)
-
-DockerBrain monitors your Docker containers in real time, detects resource issues, and uses LLMs to generate actionable optimizations for running containers and Dockerfiles. Supports **Gemini**, **Groq**, and **Ollama**. All configuration lives in a single `.dockerbrainrc` file.
-
----
-
-## Features
-
-| Feature | Command | LLM Required |
-|---|---|:---:|
-| Real-time container monitoring | `dockerb monitor` | No |
-| AI optimization suggestions | `dockerb suggest` | Yes |
-| Auto-fix containers & Dockerfiles | `dockerb fix` | Yes |
-| AI Dockerfile generation from project | `dockerb dockerize` | Yes |
-| Curated Dockerfile templates | `dockerb template` | No |
-| Environment & config diagnostics | `dockerb env` | No |
-
----
-
-## Installation
-
-**Requirements:** Python 3.10+ and a running Docker daemon.
-
-```bash
-pip install dockerbrain
-```
-
-Verify:
-
-```bash
-dockerb --version
-```
-
-### Configure an LLM Provider
-
-```bash
-dockerb init
-```
-
-This creates `.dockerbrainrc` in your project directory. Open it and set your provider and key:
-
-```ini
-[llm]
-provider = "gemini"
-model    = "gemini-3.1-flash-lite-preview"
-api_key  = "your_key_here"
-```
-
-| Provider | API Key | Link |
-|---|:---:|---|
-| Gemini | Required | [aistudio.google.com](https://aistudio.google.com/app/apikey) |
-| Groq | Required | [console.groq.com/keys](https://console.groq.com/keys) |
-| Ollama | Not Required | [ollama.com](https://ollama.com) |
-
-> `monitor`, `template`, and `env` commands work without an API key.
-
----
-
-## Usage
-
-DockerBrain exposes all functionality through the `dockerb` CLI. Run the following to see all available commands and options:
-
-```bash
-dockerb --help
-```
-
-Each command also has its own help page, for example `dockerb suggest --help`, `dockerb fix --help`, etc.
-
----
-
-## Pre-commit Hook
-
-DockerBrain can run as a [pre-commit](https://pre-commit.com/) hook to lint Dockerfiles on every commit:
-
-```yaml
-# .pre-commit-config.yaml 
-repos:
-  - repo: https://github.com/iamPulakesh/DockerBrain
-    rev: v1.0
-    hooks:
-      - id: dockerbrain-fix
-```
-
----
-
-## Development
-
-```bash
-git clone https://github.com/iamPulakesh/DockerBrain.git
-cd DockerBrain
-pip install -e ".[dev]"
-
-make test                              
-make lint                              
-make clean                    
-```
-
----
-
-See [Changelog.md](Changelog.md) for the full release history.
-
----
-
-## Contributing
-
-1. Fork the repository
-2. Contribute
-3. Open a Pull Request
-
----
-
-## License
-
-Apache-2.0 — see [LICENSE](LICENSE) for details.