gemini-manager 20.0.0__tar.gz

gemini_manager-20.0.0/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: gemini-manager
+Version: 20.0.0
+Summary: Gemini AI CLI Tool for automation
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: b2sdk>=1.18.0
+Requires-Dist: boto3>=1.28.0
+Requires-Dist: freezegun>=1.5.5
+Requires-Dist: rich>=10.0.0
+Requires-Dist: tomli>=2.0.0; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: pytest-timeout>=2.2.0; extra == "dev"
+Requires-Dist: pytest-json-report>=1.5.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pyfakefs>=5.0.0; extra == "dev"
+Requires-Dist: ruff>=0.6.0; extra == "dev"
+Requires-Dist: black>=24.3.0; extra == "dev"
+Requires-Dist: mypy>=1.11.0; extra == "dev"
+Requires-Dist: PyYAML>=6.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0; extra == "dev"
+Requires-Dist: freezegun>=1.2.0; extra == "dev"
+
+# GM AI Automation Tool
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/dhruv13x/gemini-manager/main/gemini-manager_logo.png" alt="gemini-manager logo" width="200"/>
+</div>
+
+<div align="center">
+
+[![Build status](https://github.com/dhruv13x/gemini-manager/actions/workflows/publish.yml/badge.svg)](https://github.com/dhruv13x/gemini-manager/actions/workflows/publish.yml)
+[![PyPI version](https://img.shields.io/pypi/v/gemini-manager.svg)](https://pypi.org/project/gemini-manager/)
+[![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Ruff](https://img.shields.io/badge/linting-ruff-yellow.svg)](https://github.com/astral-sh/ruff)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Maintenance](https://img.shields.io/badge/maintenance-active-green.svg)](https://github.com/dhruv13x/gemini-manager/graphs/commit-activity)
+
+</div>
+
+**The Swiss Army Knife for GM AI Automation - Backups, Cloud Sync, and Account Management.**
+
+`gemini-manager` is a powerful, "batteries-included" command-line interface designed to supercharge your GM AI experience. It handles backups (Local, S3, B2), synchronizes data across devices, manages multiple profiles, and intelligently tracks account usage to bypass rate limits.
+
+---
+
+## ⚡ Quick Start (The "5-Minute Rule")
+
+### Prerequisites
+- **Python**: 3.8 or higher
+- **Optional**: [AWS CLI](https://aws.amazon.com/cli/) or [Backblaze B2 CLI](https://www.backblaze.com/b2/docs/quick_command_line.html) for credentials management.
+
+### Installation
+
+```bash
+# Install from PyPI
+pip install gemini-manager
+
+# Or install from source
+pip install .
+```
+
+### Get Started Immediately
+
+Copy and paste this snippet to configure your first profile, backup to the cloud, and verify your system health.
+
+```bash
+# 1. Run the interactive setup wizard
+gm config --init
+
+# 2. Run your first local backup
+gm backup
+
+# 3. Push your backup to the cloud (requires configured credentials)
+gm sync push
+
+# 4. Check the account dashboard
+gm cooldown --cloud
+
+# 5. Get a smart account recommendation
+gm recommend
+```
+
+---
+
+## ✨ Features
+
+### Core Capabilities
+*   **🛡️ God Level Backups**: Securely backup your configuration and chat history to **Local**, **AWS S3**, or **Backblaze B2** storage. Supports **GPG Encryption** for sensitive data.
+*   **🌍 Machine-Time Adaptive**: Automatically detects and uses your system's local timezone for all calculations and displays. No more manual IST/UTC conversions.
+*   **☁️ Unified Cloud Sync**: Seamlessly `push` and `pull` backups between your local machine and the cloud.
+
+### Smart Automation
+*   **⏱️ Smart Session Tracking**: Tracks "First Used" timestamps to accurately predict GM's 24-hour rolling quota resets.
+*   **🧠 Intelligent Rotation**: Automatically recommends the "healthiest" account based on session start times and Least Recently Used (LRU) logic.
+*   **🛡️ Accident Protection**: Safeguards your session data by preventing accidental account switches from resetting your 24-hour quota clock.
+
+### Diagnostics & Management
+*   **📊 Visual Analytics**: View beautiful, terminal-based bar charts of your usage history and account health.
+*   **🩺 Doctor Mode**: Built-in diagnostic tool to validate your environment, dependencies, and configuration health.
+*   **🧹 Auto-Pruning**: Automatically cleans up old backups and temporary files to keep your storage efficient.
+
+---
+
+## 🛠️ Configuration
+
+You can configure `gemini-manager` using **Environment Variables**, **CLI Arguments**, or the **Interactive Config** (`gm config --init`).
+
+**Priority Order**: CLI Arguments > Environment Variables > `.env` / Doppler > Saved Config (`~/.gemini-manager/settings.json`)
+
+### Backup Naming Convention
+
+`gemini-manager` uses a strict naming convention for backups to enable automatic discovery and account rotation.
+
+*   **Archives**: `YYYY-MM-DD_HHMMSS-email@example.com.gemini-manager.tar.gz`
+*   **Encrypted Archives**: `...tar.gz.gpg`
+*   **Metadata**: `YYYY-MM-DD_HHMMSS-email@example.com.gemini-manager.metadata.json`
+
+The timestamp in the filename is typically the **scheduled reset time** (in your local timezone) for that account, allowing the tool to quickly identify which backup belongs to which session window.
+
+### Environment Variables
+
+| Variable | Description | Default | Required |
+| :--- | :--- | :--- | :--- |
+| `GEMINI_AWS_ACCESS_KEY_ID` | AWS Access Key ID for S3. | None | No (for S3) |
+| `GEMINI_AWS_SECRET_ACCESS_KEY` | AWS Secret Access Key for S3. | None | No (for S3) |
+| `GEMINI_S3_BUCKET` | AWS S3 Bucket Name. | None | No (for S3) |
+| `GEMINI_S3_REGION` | AWS Region. | `us-east-1` | No |
+| `GEMINI_B2_KEY_ID` | Backblaze B2 Application Key ID. | None | No (for B2) |
+| `GEMINI_B2_APP_KEY` | Backblaze B2 Application Key. | None | No (for B2) |
+| `GEMINI_B2_BUCKET` | Backblaze B2 Bucket Name. | None | No (for B2) |
+| `GEMINI_BACKUP_PASSWORD` | Password for GPG encryption. | None | No (for `--encrypt`) |
+| `DOPPLER_TOKEN` | Token for Doppler secrets management. | None | No |
+
+### Key CLI Arguments
+
+| Command | Flag | Description |
+| :--- | :--- | :--- |
+| `backup` | `--encrypt` | Encrypt the backup archive using GPG. |
+| `restore` | `--auto` | Automatically select and restore the latest backup for the best available account. |
+| `prune` | `--cloud-only` | Only remove old backups from cloud storage, keeping local copies. |
+| `config` | `--force` | Force overwrite existing configuration values. |
+| `cooldown` | `--reset-all` | **DANGER**: Wipe all cooldown data (local and cloud). |
+
+---
+
+## 🏗️ Architecture
+
+The `gemini-manager` is built with modularity and extensibility in mind.
+
+```text
+src/gemini_manager/
+├── cli.py             # 🚀 Entry Point & Argument Routing
+├── config.py          # ⚙️ Global Constants & Paths
+├── backup.py          # 📦 Backup Logic (Local & Cloud dispatch)
+├── restore.py         # ♻️ Restore Logic (Auto-selection & Session logs)
+├── cooldown.py        # ❄️ Master Dashboard & Adaptive Time Logic
+├── recommend.py       # 🧠 Recommendation Engine (Session-aware)
+├── sync.py            # 🔄 Unified Sync (Push/Pull)
+├── cloud_factory.py   # ☁️ Cloud Provider Abstract Factory
+└── stats.py           # 📊 Visualization Module
+```
+
+### Data Flow
+1.  **User Input**: CLI args are parsed by `args.py` and routed by `cli.py`.
+2.  **Configuration**: Settings are loaded from `settings_cli.py` (merging Env, CLI, and Config).
+3.  **Action**:
+    - **Backup**: Compresses `~/.gemini-manager`, encrypts (optional), and uploads via `CloudFactory`.
+    - **Restore**: Fetches list from cloud/local, decrypts, and extracts to `~/.gemini-manager`.
+    - **Recommendation**: Queries `cooldown.py` for account status and selects the LRU "Ready" account.
+4.  **Persistence**: Usage stats and cooldowns are saved to JSON files in `~/.gemini-manager`.
+
+---
+
+## 🐞 Troubleshooting
+
+| Error Message | Possible Cause | Solution |
+| :--- | :--- | :--- |
+| `ModuleNotFoundError: No module named 'gemini_manager'` | Installation issue. | Run `pip install -e .` or ensure you are in the correct venv. |
+| `gpg: decryption failed: No secret key` | Missing GPG key or wrong password. | Ensure `GEMINI_BACKUP_PASSWORD` is set or the GPG key is imported. |
+| `ClientError: An error occurred (403) ...` | AWS/B2 Credentials invalid. | Check your `GEMINI_*` env vars or `~/.aws/credentials`. |
+| `Permission denied: '~/.gemini-manager'` | File permission issues. | Run `chown -R $USER ~/.gemini-manager` or check directory permissions. |
+
+**Debug Mode**: Currently, you can increase verbosity by inspecting the logs or running with standard python tracebacks enabled (default).
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Whether it's reporting a bug, suggesting a feature, or writing code.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions.
+
+1.  **Setup Dev Environment**: `pip install -e .[dev]`
+2.  **Run Tests**: `pytest tests/`
+3.  **Submit PR**: Follow the guidelines in the contributing guide.
+
+---
+
+## 🗺️ Roadmap
+
+*   **Phase 1 (Completed)**: Core Backup/Restore, Multi-Cloud (S3/B2), Sync, Auto-Updates.
+*   **Phase 2 (Completed)**: Machine-Time Adaptation, Session Tracking, Smart Rotation.
+*   **Phase 3 (Upcoming)**:
+    *   🔔 **Webhooks**: Slack/Discord notifications for backup status.
+    *   🐍 **Python SDK**: Import `gemini_manager` as a library in your own scripts.
+*   **Phase 4 (Vision)**: AI-driven anomaly detection and self-healing infrastructure.
+
+See [ROADMAP.md](ROADMAP.md) for the full detailed vision.

gemini_manager-20.0.0/README.md

@@ -0,0 +1,187 @@
+# GM AI Automation Tool
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/dhruv13x/gemini-manager/main/gemini-manager_logo.png" alt="gemini-manager logo" width="200"/>
+</div>
+
+<div align="center">
+
+[![Build status](https://github.com/dhruv13x/gemini-manager/actions/workflows/publish.yml/badge.svg)](https://github.com/dhruv13x/gemini-manager/actions/workflows/publish.yml)
+[![PyPI version](https://img.shields.io/pypi/v/gemini-manager.svg)](https://pypi.org/project/gemini-manager/)
+[![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Ruff](https://img.shields.io/badge/linting-ruff-yellow.svg)](https://github.com/astral-sh/ruff)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Maintenance](https://img.shields.io/badge/maintenance-active-green.svg)](https://github.com/dhruv13x/gemini-manager/graphs/commit-activity)
+
+</div>
+
+**The Swiss Army Knife for GM AI Automation - Backups, Cloud Sync, and Account Management.**
+
+`gemini-manager` is a powerful, "batteries-included" command-line interface designed to supercharge your GM AI experience. It handles backups (Local, S3, B2), synchronizes data across devices, manages multiple profiles, and intelligently tracks account usage to bypass rate limits.
+
+---
+
+## ⚡ Quick Start (The "5-Minute Rule")
+
+### Prerequisites
+- **Python**: 3.8 or higher
+- **Optional**: [AWS CLI](https://aws.amazon.com/cli/) or [Backblaze B2 CLI](https://www.backblaze.com/b2/docs/quick_command_line.html) for credentials management.
+
+### Installation
+
+```bash
+# Install from PyPI
+pip install gemini-manager
+
+# Or install from source
+pip install .
+```
+
+### Get Started Immediately
+
+Copy and paste this snippet to configure your first profile, backup to the cloud, and verify your system health.
+
+```bash
+# 1. Run the interactive setup wizard
+gm config --init
+
+# 2. Run your first local backup
+gm backup
+
+# 3. Push your backup to the cloud (requires configured credentials)
+gm sync push
+
+# 4. Check the account dashboard
+gm cooldown --cloud
+
+# 5. Get a smart account recommendation
+gm recommend
+```
+
+---
+
+## ✨ Features
+
+### Core Capabilities
+*   **🛡️ God Level Backups**: Securely backup your configuration and chat history to **Local**, **AWS S3**, or **Backblaze B2** storage. Supports **GPG Encryption** for sensitive data.
+*   **🌍 Machine-Time Adaptive**: Automatically detects and uses your system's local timezone for all calculations and displays. No more manual IST/UTC conversions.
+*   **☁️ Unified Cloud Sync**: Seamlessly `push` and `pull` backups between your local machine and the cloud.
+
+### Smart Automation
+*   **⏱️ Smart Session Tracking**: Tracks "First Used" timestamps to accurately predict GM's 24-hour rolling quota resets.
+*   **🧠 Intelligent Rotation**: Automatically recommends the "healthiest" account based on session start times and Least Recently Used (LRU) logic.
+*   **🛡️ Accident Protection**: Safeguards your session data by preventing accidental account switches from resetting your 24-hour quota clock.
+
+### Diagnostics & Management
+*   **📊 Visual Analytics**: View beautiful, terminal-based bar charts of your usage history and account health.
+*   **🩺 Doctor Mode**: Built-in diagnostic tool to validate your environment, dependencies, and configuration health.
+*   **🧹 Auto-Pruning**: Automatically cleans up old backups and temporary files to keep your storage efficient.
+
+---
+
+## 🛠️ Configuration
+
+You can configure `gemini-manager` using **Environment Variables**, **CLI Arguments**, or the **Interactive Config** (`gm config --init`).
+
+**Priority Order**: CLI Arguments > Environment Variables > `.env` / Doppler > Saved Config (`~/.gemini-manager/settings.json`)
+
+### Backup Naming Convention
+
+`gemini-manager` uses a strict naming convention for backups to enable automatic discovery and account rotation.
+
+*   **Archives**: `YYYY-MM-DD_HHMMSS-email@example.com.gemini-manager.tar.gz`
+*   **Encrypted Archives**: `...tar.gz.gpg`
+*   **Metadata**: `YYYY-MM-DD_HHMMSS-email@example.com.gemini-manager.metadata.json`
+
+The timestamp in the filename is typically the **scheduled reset time** (in your local timezone) for that account, allowing the tool to quickly identify which backup belongs to which session window.
+
+### Environment Variables
+
+| Variable | Description | Default | Required |
+| :--- | :--- | :--- | :--- |
+| `GEMINI_AWS_ACCESS_KEY_ID` | AWS Access Key ID for S3. | None | No (for S3) |
+| `GEMINI_AWS_SECRET_ACCESS_KEY` | AWS Secret Access Key for S3. | None | No (for S3) |
+| `GEMINI_S3_BUCKET` | AWS S3 Bucket Name. | None | No (for S3) |
+| `GEMINI_S3_REGION` | AWS Region. | `us-east-1` | No |
+| `GEMINI_B2_KEY_ID` | Backblaze B2 Application Key ID. | None | No (for B2) |
+| `GEMINI_B2_APP_KEY` | Backblaze B2 Application Key. | None | No (for B2) |
+| `GEMINI_B2_BUCKET` | Backblaze B2 Bucket Name. | None | No (for B2) |
+| `GEMINI_BACKUP_PASSWORD` | Password for GPG encryption. | None | No (for `--encrypt`) |
+| `DOPPLER_TOKEN` | Token for Doppler secrets management. | None | No |
+
+### Key CLI Arguments
+
+| Command | Flag | Description |
+| :--- | :--- | :--- |
+| `backup` | `--encrypt` | Encrypt the backup archive using GPG. |
+| `restore` | `--auto` | Automatically select and restore the latest backup for the best available account. |
+| `prune` | `--cloud-only` | Only remove old backups from cloud storage, keeping local copies. |
+| `config` | `--force` | Force overwrite existing configuration values. |
+| `cooldown` | `--reset-all` | **DANGER**: Wipe all cooldown data (local and cloud). |
+
+---
+
+## 🏗️ Architecture
+
+The `gemini-manager` is built with modularity and extensibility in mind.
+
+```text
+src/gemini_manager/
+├── cli.py             # 🚀 Entry Point & Argument Routing
+├── config.py          # ⚙️ Global Constants & Paths
+├── backup.py          # 📦 Backup Logic (Local & Cloud dispatch)
+├── restore.py         # ♻️ Restore Logic (Auto-selection & Session logs)
+├── cooldown.py        # ❄️ Master Dashboard & Adaptive Time Logic
+├── recommend.py       # 🧠 Recommendation Engine (Session-aware)
+├── sync.py            # 🔄 Unified Sync (Push/Pull)
+├── cloud_factory.py   # ☁️ Cloud Provider Abstract Factory
+└── stats.py           # 📊 Visualization Module
+```
+
+### Data Flow
+1.  **User Input**: CLI args are parsed by `args.py` and routed by `cli.py`.
+2.  **Configuration**: Settings are loaded from `settings_cli.py` (merging Env, CLI, and Config).
+3.  **Action**:
+    - **Backup**: Compresses `~/.gemini-manager`, encrypts (optional), and uploads via `CloudFactory`.
+    - **Restore**: Fetches list from cloud/local, decrypts, and extracts to `~/.gemini-manager`.
+    - **Recommendation**: Queries `cooldown.py` for account status and selects the LRU "Ready" account.
+4.  **Persistence**: Usage stats and cooldowns are saved to JSON files in `~/.gemini-manager`.
+
+---
+
+## 🐞 Troubleshooting
+
+| Error Message | Possible Cause | Solution |
+| :--- | :--- | :--- |
+| `ModuleNotFoundError: No module named 'gemini_manager'` | Installation issue. | Run `pip install -e .` or ensure you are in the correct venv. |
+| `gpg: decryption failed: No secret key` | Missing GPG key or wrong password. | Ensure `GEMINI_BACKUP_PASSWORD` is set or the GPG key is imported. |
+| `ClientError: An error occurred (403) ...` | AWS/B2 Credentials invalid. | Check your `GEMINI_*` env vars or `~/.aws/credentials`. |
+| `Permission denied: '~/.gemini-manager'` | File permission issues. | Run `chown -R $USER ~/.gemini-manager` or check directory permissions. |
+
+**Debug Mode**: Currently, you can increase verbosity by inspecting the logs or running with standard python tracebacks enabled (default).
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Whether it's reporting a bug, suggesting a feature, or writing code.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions.
+
+1.  **Setup Dev Environment**: `pip install -e .[dev]`
+2.  **Run Tests**: `pytest tests/`
+3.  **Submit PR**: Follow the guidelines in the contributing guide.
+
+---
+
+## 🗺️ Roadmap
+
+*   **Phase 1 (Completed)**: Core Backup/Restore, Multi-Cloud (S3/B2), Sync, Auto-Updates.
+*   **Phase 2 (Completed)**: Machine-Time Adaptation, Session Tracking, Smart Rotation.
+*   **Phase 3 (Upcoming)**:
+    *   🔔 **Webhooks**: Slack/Discord notifications for backup status.
+    *   🐍 **Python SDK**: Import `gemini_manager` as a library in your own scripts.
+*   **Phase 4 (Vision)**: AI-driven anomaly detection and self-healing infrastructure.
+
+See [ROADMAP.md](ROADMAP.md) for the full detailed vision.

gemini_manager-20.0.0/pyproject.toml

@@ -0,0 +1,85 @@
+[project]
+name = "gemini-manager"
+version = "20.0.0"
+description = "Gemini AI CLI Tool for automation"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "b2sdk>=1.18.0",
+    "boto3>=1.28.0",
+    "freezegun>=1.5.5",
+    "rich>=10.0.0",
+    "tomli>=2.0.0; python_version < '3.11'",
+]
+
+[project.scripts]
+gm = "gemini_manager.cli:main"
+gemini-manager = "gemini_manager.cli:main"
+
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+
+
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0.0",
+  "pytest-cov>=5.0.0",
+  "pytest-timeout>=2.2.0",
+  "pytest-json-report>=1.5.0",
+  "pytest-asyncio>=0.23.0",
+  "pytest-mock>=3.10.0",
+  "pyfakefs>=5.0.0",
+  "ruff>=0.6.0",
+  "black>=24.3.0",
+  "mypy>=1.11.0",
+  "PyYAML>=6.0",
+  "types-PyYAML>=6.0",
+  "freezegun>=1.2.0"
+]
+
+[tool.pytest.ini_options]
+# All projects use src/ layout
+pythonpath = ["src"]
+
+# All tests live under tests/
+testpaths = ["tests"]
+
+# Async projects are common in your stack
+asyncio_mode = "auto"
+
+# Global pytest options
+addopts = [
+  "-v",
+  "-ra",
+  "--strict-config",
+  "--strict-markers",
+  "--tb=short",
+  "--showlocals",
+  "--import-mode=importlib",
+
+  # Time & perf
+  "--timeout=10",
+  "--durations=10",
+
+  # Coverage: target the real package
+  "--cov=src/gemini_manager",
+  "--cov-report=term-missing:skip-covered",
+  "--cov-report=html",
+  "--cov-report=xml",
+  "--cov-fail-under=85",
+]
+
+log_cli = true
+log_cli_level = "INFO"
+
+[tool.coverage.run]
+branch = true
+source = ["src/gemini_manager"]
+
+[tool.coverage.report]
+fail_under = 85
+show_missing = true
+skip_covered = true

gemini_manager-20.0.0/setup.cfg

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

gemini_manager-20.0.0/src/__init__.py

@@ -0,0 +1,2 @@
+# src/__init__.py
+

gemini_manager-20.0.0/src/gemini_manager/__init__.py

@@ -0,0 +1,2 @@
+# src/gemini_manager/__init__.py
+