octopize.deploy_tool 0.1.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

octopize_avatar_deploy/configure.py

@@ -30,6 +30,8 @@ import yaml
 from jinja2 import Environment, FileSystemLoader
 
 from octopize_avatar_deploy.download_templates import (
+    REQUIRED_DOCKER_FILES,
+    REQUIRED_TEMPLATE_FILES,
     LocalTemplateProvider,
     download_templates,
 )
@@ -187,7 +189,9 @@ class DeploymentConfigurator:
 
             output_path = self.output_dir / output_name
             output_path.parent.mkdir(parents=True, exist_ok=True)
-            output_path.write_text(rendered)
+            # Ensure trailing newline for pre-commit end-of-file-fixer
+            content = rendered if rendered.endswith("\n") else rendered + "\n"
+            output_path.write_text(content)
 
             self.printer.print_success(f"Generated: {output_path}")
         except Exception as e:
@@ -215,13 +219,32 @@ class DeploymentConfigurator:
             "authentik/octopize-avatar-blueprint.yaml",
         )
 
-        # Copy docker-compose.yml from templates (it may be templated in the future)
+        # Copy docker-compose.yml from templates
         docker_compose_src = self.templates_dir / "docker-compose.yml"
         docker_compose_dst = self.output_dir / "docker-compose.yml"
         if docker_compose_src.exists():
             shutil.copy2(docker_compose_src, docker_compose_dst)
             self.printer.print_success(f"Generated: {docker_compose_dst}")
 
+        # Copy authentik custom templates (email templates)
+        custom_templates_src = self.templates_dir / "authentik" / "custom-templates"
+        custom_templates_dst = self.output_dir / "authentik" / "custom-templates"
+        if custom_templates_src.exists():
+            custom_templates_dst.mkdir(parents=True, exist_ok=True)
+            for template_file in custom_templates_src.glob("*.html"):
+                shutil.copy2(template_file, custom_templates_dst / template_file.name)
+            self.printer.print_success(f"Copied: email templates to {custom_templates_dst}")
+
+        # Copy authentik branding files
+        branding_src = self.templates_dir / "authentik" / "branding"
+        branding_dst = self.output_dir / "authentik" / "branding"
+        if branding_src.exists():
+            branding_dst.mkdir(parents=True, exist_ok=True)
+            for branding_file in branding_src.glob("*"):
+                if branding_file.is_file():
+                    shutil.copy2(branding_file, branding_dst / branding_file.name)
+            self.printer.print_success(f"Copied: branding files to {branding_dst}")
+
         self.printer.print()
         self.printer.print_success("Configuration files generated successfully!")
 
@@ -263,7 +286,7 @@ class DeploymentConfigurator:
         # Check for existing state and prompt to resume or restart
         if self.state and self.state.has_started() and not self.state.is_complete():
             if interactive:
-                self.state.print_status()
+                self.state.print_status(self.printer)
                 self.printer.print_header("")
                 response = self.input_gatherer.prompt_yes_no(
                     "Resume from where you left off?", default=True
@@ -481,16 +504,19 @@ class DeploymentRunner:
         Returns:
             True if templates are available, False otherwise
         """
-        from octopize_avatar_deploy.download_templates import REQUIRED_FILES
-
         if not self.templates_dir.exists():
             if self.verbose:
                 self.printer.print_error(f"Templates directory not found: {self.templates_dir}")
             return False
 
-        # Check for required files
+        # Check for required template files
         missing_files = []
-        for filename in REQUIRED_FILES:
+        for filename in REQUIRED_TEMPLATE_FILES:
+            if not (self.templates_dir / filename).exists():
+                missing_files.append(filename)
+
+        # Check for required docker files
+        for filename in REQUIRED_DOCKER_FILES:
             if not (self.templates_dir / filename).exists():
                 missing_files.append(filename)
 
@@ -501,8 +527,9 @@ class DeploymentRunner:
                 )
             return False
 
+        total_files = len(REQUIRED_TEMPLATE_FILES) + len(REQUIRED_DOCKER_FILES)
         if self.verbose:
-            self.printer.print_success(f"Found all {len(REQUIRED_FILES)} required template files")
+            self.printer.print_success(f"Found all {total_files} required template files")
 
         # Validate template version compatibility
         return self._validate_template_version()

octopize_avatar_deploy/defaults.yaml

@@ -1,63 +1,47 @@
-# Default Configuration Values for Avatar Deployment
-# Version: 1.0.0 (MAJOR.MINOR.PATCH)
-# Compatible with script version: >=1.0.0,<2.0.0
-
-version: "1.0.0"
-
-# Image versions - updated regularly with new releases
+version: 1.0.0
 images:
-  api: "2.20.1"
-  web: "0.40.0"
-  pdfgenerator: "latest"
-  seaweedfs: "0.2.0"
-  authentik: "2025.10.2"
-
-# Email configuration defaults
+  api: 2.47.0
+  web: 0.52.0
+  pdfgenerator: 0.2.3
+  seaweedfs: 0.4.0
+  authentik: 2025.12.3
 email:
-  provider: "aws"  # 'aws' or 'smtp'
+  provider: aws
   smtp:
-    host: "email-smtp.eu-west-3.amazonaws.com"
-    port: "587"
-    use_tls: "true"
-    start_tls: "false"
-    verify: "true"
-    sender_email: "noreply@octopize.io"
-
-# Telemetry configuration (for usage analytics)
+    host: email-smtp.eu-west-3.amazonaws.com
+    port: '587'
+    use_tls: 'true'
+    start_tls: 'false'
+    verify: 'true'
+    sender_email: noreply@octopize.io
 telemetry:
-  enabled: true  # Ask user if they want to enable telemetry
-  endpoint_url: "https://s3.fr-par.scw.cloud"
-  region: "fr-par"
-
-# Application settings (defaults when no preset is selected)
+  enabled: true
+  endpoint_url: https://s3.fr-par.scw.cloud
+  region: fr-par
 application:
-  use_console_logging: "false"
-  log_level: "INFO"
-  sentry_enabled: "true"
-  email_authentication: "true"
-
-# Deployment presets - pre-configured settings for common scenarios
+  use_console_logging: 'false'
+  log_level: INFO
+  sentry_enabled: 'true'
+  email_authentication: 'true'
 presets:
   default:
-    description: "Production-ready configuration with telemetry and monitoring"
+    description: Production-ready configuration with telemetry and monitoring
     application:
-      use_console_logging: "false"
-      sentry_enabled: "true"
+      use_console_logging: 'false'
+      sentry_enabled: 'true'
     telemetry:
       enabled: true
-
   dev-mode:
-    description: "Development mode with console logging, no external services"
+    description: Development mode with console logging, no external services
     application:
-      use_console_logging: "true"
-      sentry_enabled: "false"
+      use_console_logging: 'true'
+      sentry_enabled: 'false'
     telemetry:
       enabled: false
-
   airgapped:
-    description: "Air-gapped deployment without external monitoring or telemetry"
+    description: Air-gapped deployment without external monitoring or telemetry
     application:
-      use_console_logging: "false"
-      sentry_enabled: "false"
+      use_console_logging: 'false'
+      sentry_enabled: 'false'
     telemetry:
       enabled: false

octopize_avatar_deploy/download_templates.py

@@ -15,7 +15,7 @@ GITHUB_RAW_BASE = "https://raw.githubusercontent.com/octopize/avatar-deployment"
 DEFAULT_BRANCH = "main"
 
 # Files to download from the docker/templates/ directory
-REQUIRED_FILES = [
+REQUIRED_TEMPLATE_FILES = [
     ".env.template",
     "nginx.conf.template",
     "docker-compose.yml",
@@ -23,6 +23,19 @@ REQUIRED_FILES = [
     "authentik/octopize-avatar-blueprint.yaml.j2",
 ]
 
+# Additional files to download from docker/ directory (not in templates/)
+REQUIRED_DOCKER_FILES = [
+    "authentik/custom-templates/email_account_confirmation.html",
+    "authentik/custom-templates/email_account_exists.html",
+    "authentik/custom-templates/email_account_invitation.html",
+    "authentik/custom-templates/email_forgotten_password.html",
+    "authentik/custom-templates/email_password_changed.html",
+    "authentik/custom-templates/email_password_reset.html",
+    "authentik/branding/favicon.ico",
+    "authentik/branding/logo.png",
+    "authentik/branding/background.png",
+]
+
 
 class TemplateProvider(ABC):
     """Abstract base class for template providers."""
@@ -37,12 +50,26 @@ class TemplateProvider(ABC):
         self.verbose = verbose
 
     @abstractmethod
-    def provide_file(self, filename: str, destination: Path) -> bool:
+    def provide_template_file(self, filename: str, destination: Path) -> bool:
+        """
+        Provide a single template file to the destination.
+
+        Args:
+            filename: Name of file to provide (from docker/templates/)
+            destination: Local path where file should be saved
+
+        Returns:
+            True if successful, False otherwise
+        """
+        pass
+
+    @abstractmethod
+    def provide_docker_file(self, filename: str, destination: Path) -> bool:
         """
-        Provide a single file to the destination.
+        Provide a single docker file to the destination.
 
         Args:
-            filename: Name of file to provide
+            filename: Name of file to provide (from docker/)
             destination: Local path where file should be saved
 
         Returns:
@@ -52,7 +79,7 @@ class TemplateProvider(ABC):
 
     def provide_all(self, output_dir: Path) -> bool:
         """
-        Provide all required template files.
+        Provide all required template and docker files.
 
         Args:
             output_dir: Directory where files should be saved
@@ -67,9 +94,17 @@ class TemplateProvider(ABC):
             print(f"\nProviding templates to {output_dir}/")
             print("=" * 60)
 
-        for filename in REQUIRED_FILES:
+        # Provide template files
+        for filename in REQUIRED_TEMPLATE_FILES:
+            destination = output_dir / filename
+            if not self.provide_template_file(filename, destination):
+                success = False
+                print(f"⚠ Warning: Failed to provide {filename}")
+
+        # Provide docker files (authentik branding, email templates, etc.)
+        for filename in REQUIRED_DOCKER_FILES:
             destination = output_dir / filename
-            if not self.provide_file(filename, destination):
+            if not self.provide_docker_file(filename, destination):
                 success = False
                 print(f"⚠ Warning: Failed to provide {filename}")
 
@@ -92,7 +127,10 @@ class TemplateProvider(ABC):
             True if all required files exist
         """
         output_dir = Path(output_dir)
-        for filename in REQUIRED_FILES:
+        for filename in REQUIRED_TEMPLATE_FILES:
+            if not (output_dir / filename).exists():
+                return False
+        for filename in REQUIRED_DOCKER_FILES:
             if not (output_dir / filename).exists():
                 return False
         return True
@@ -111,11 +149,12 @@ class GitHubTemplateProvider(TemplateProvider):
         """
         super().__init__(verbose=verbose)
         self.branch = branch
-        self.base_url = f"{GITHUB_RAW_BASE}/{branch}/docker/templates"
+        self.templates_base_url = f"{GITHUB_RAW_BASE}/{branch}/docker/templates"
+        self.docker_base_url = f"{GITHUB_RAW_BASE}/{branch}/docker"
 
-    def provide_file(self, filename: str, destination: Path) -> bool:
+    def provide_template_file(self, filename: str, destination: Path) -> bool:
         """
-        Download a single file from GitHub.
+        Download a single template file from GitHub.
 
         Args:
             filename: Name of file to download (in docker/templates/ directory)
@@ -124,7 +163,7 @@ class GitHubTemplateProvider(TemplateProvider):
         Returns:
             True if successful, False otherwise
         """
-        url = f"{self.base_url}/{filename}"
+        url = f"{self.templates_base_url}/{filename}"
 
         if self.verbose:
             print(f"Downloading {filename}...")
@@ -151,21 +190,43 @@ class GitHubTemplateProvider(TemplateProvider):
                 print(f"  ✗ Failed: {e}")
             return False
 
-    def check_cached_templates(self, output_dir: Path) -> bool:
+    def provide_docker_file(self, filename: str, destination: Path) -> bool:
         """
-        Check if templates are already cached locally.
+        Download a single docker file from GitHub.
 
         Args:
-            output_dir: Directory to check for cached templates
+            filename: Name of file to download (in docker/ directory)
+            destination: Local path where file should be saved
 
         Returns:
-            True if all required files exist
+            True if successful, False otherwise
         """
-        output_dir = Path(output_dir)
-        for filename in REQUIRED_FILES:
-            if not (output_dir / filename).exists():
-                return False
-        return True
+        url = f"{self.docker_base_url}/{filename}"
+
+        if self.verbose:
+            print(f"Downloading {filename}...")
+            print(f"  URL: {url}")
+            print(f"  Destination: {destination}")
+
+        try:
+            with urllib.request.urlopen(url, timeout=10) as response:
+                content = response.read()
+
+            # Ensure parent directory exists
+            destination.parent.mkdir(parents=True, exist_ok=True)
+
+            # Write file
+            destination.write_bytes(content)
+
+            if self.verbose:
+                print(f"  ✓ Downloaded {len(content)} bytes")
+
+            return True
+
+        except Exception as e:
+            if self.verbose:
+                print(f"  ✗ Failed: {e}")
+            return False
 
 
 class LocalTemplateProvider(TemplateProvider):
@@ -176,18 +237,20 @@ class LocalTemplateProvider(TemplateProvider):
         Initialize local template provider.
 
         Args:
-            source_dir: Local directory containing template files
+            source_dir: Local directory containing template files (docker/templates/)
             verbose: Print progress information
         """
         super().__init__(verbose=verbose)
         self.source_dir = Path(source_dir)
+        # Parent of templates is docker/
+        self.docker_dir = self.source_dir.parent
 
-    def provide_file(self, filename: str, destination: Path) -> bool:
+    def provide_template_file(self, filename: str, destination: Path) -> bool:
         """
-        Copy a single file from source to destination.
+        Copy a single template file from source to destination.
 
         Args:
-            filename: Name of file to copy
+            filename: Name of file to copy (from docker/templates/)
             destination: Local path where file should be saved
 
         Returns:
@@ -220,6 +283,44 @@ class LocalTemplateProvider(TemplateProvider):
                 print(f"  ✗ Failed: {e}")
             return False
 
+    def provide_docker_file(self, filename: str, destination: Path) -> bool:
+        """
+        Copy a single docker file from source to destination.
+
+        Args:
+            filename: Name of file to copy (from docker/)
+            destination: Local path where file should be saved
+
+        Returns:
+            True if successful, False otherwise
+        """
+        source = self.docker_dir / filename
+
+        if self.verbose:
+            print(f"Copying {filename}...")
+            print(f"  Source: {source}")
+            print(f"  Destination: {destination}")
+
+        try:
+            if not source.exists():
+                raise FileNotFoundError(f"Source file not found: {source}")
+
+            # Ensure parent directory exists
+            destination.parent.mkdir(parents=True, exist_ok=True)
+
+            # Copy file
+            shutil.copy2(source, destination)
+
+            if self.verbose:
+                print(f"  ✓ Copied {source.stat().st_size} bytes")
+
+            return True
+
+        except Exception as e:
+            if self.verbose:
+                print(f"  ✗ Failed: {e}")
+            return False
+
 
 def download_templates(
     output_dir: Path,

octopize_avatar_deploy/state_manager.py

@@ -116,21 +116,28 @@ class DeploymentState:
         total = len(self.steps)
         return f"{completed}/{total} steps completed"
 
-    def print_status(self) -> None:
-        """Print current status."""
-        print("\n" + "=" * 60)
-        print("Deployment Configuration Status")
-        print("=" * 60)
-        print(f"\n{self.get_progress_summary()}\n")
+    def print_status(self, printer=None) -> None:
+        """
+        Print current status.
+
+        Args:
+            printer: Optional printer to use for output. If None, uses built-in print().
+        """
+        _print = printer.print if printer else print
+
+        _print("\n" + "=" * 60)
+        _print("Deployment Configuration Status")
+        _print("=" * 60)
+        _print(f"\n{self.get_progress_summary()}\n")
 
         for step in self.steps:
             status = self.get_step_status(step)
             icon = "✓" if status == "completed" else "○" if status == "not-started" else "◐"
-            print(f"  {icon} {step.replace('_', ' ').title()}: {status}")
+            _print(f"  {icon} {step.replace('_', ' ').title()}: {status}")
 
         if self.is_complete():
-            print("\n✓ Configuration is complete!")
+            _print("\n✓ Configuration is complete!")
         elif self.has_started():
             next_step = self.get_next_step()
             if next_step:
-                print(f"\n→ Next step: {next_step.replace('_', ' ').title()}")
+                _print(f"\n→ Next step: {next_step.replace('_', ' ').title()}")

octopize_avatar_deploy/steps/required.py

@@ -19,11 +19,16 @@ class RequiredConfigStep(DeploymentStep):
 
         # Public URL - Required
         if "PUBLIC_URL" in self.config:
-            config["PUBLIC_URL"] = self.config["PUBLIC_URL"]
+            public_url = self.config["PUBLIC_URL"]
         elif self.interactive:
-            config["PUBLIC_URL"] = self.prompt("Public URL (domain name, e.g., avatar.example.com)")
+            public_url = self.prompt("Public URL (domain name, e.g., avatar.example.com)")
         else:
-            config["PUBLIC_URL"] = ""
+            public_url = ""
+
+        # Normalize PUBLIC_URL to strip protocol and store just the domain
+        if public_url:
+            public_url = public_url.replace("https://", "").replace("http://", "").rstrip("/")
+        config["PUBLIC_URL"] = public_url
 
         # Environment name - Required
         if "ENV_NAME" in self.config:

octopize_avatar_deploy/steps/telemetry.py

@@ -50,9 +50,10 @@ class TelemetryStep(DeploymentStep):
     def generate_secrets(self) -> dict[str, str]:
         """Generate telemetry-related secrets."""
         # Only generate secrets if telemetry is enabled
-        if self.config["TELEMETRY_S3_ENDPOINT_URL"]:
-            return {
-                "telemetry_s3_access_key_id": "",
-                "telemetry_s3_secret_access_key": "",
-            }
+
+        # The user will have to provide these if telemetry is enabled
+        return {
+            "telemetry_s3_access_key_id": "",
+            "telemetry_s3_secret_access_key": "",
+        }
         return {}

octopize_avatar_deploy/version_compat.py

@@ -9,7 +9,7 @@ import re
 from pathlib import Path
 
 # Script version (semantic versioning: MAJOR.MINOR.PATCH)
-SCRIPT_VERSION = "2.1.0"
+SCRIPT_VERSION = "2.6.0"
 
 
 class VersionError(Exception):

octopize_deploy_tool-0.3.0.dist-info/METADATA

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: octopize.deploy_tool
+Version: 0.3.0
+Summary: Deployment configuration tool for Octopize Avatar platform
+Project-URL: Homepage, https://octopize.io
+Project-URL: Documentation, https://docs.octopize.io/docs/deploying/self-hosted
+Project-URL: Repository, https://github.com/octopize/avatar-deployment
+Project-URL: Issues, https://github.com/octopize/avatar-deployment/issues
+Author-email: Octopize <contact@octopize.io>
+License: MIT
+Keywords: avatar,configuration,deployment,octopize
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Installation/Setup
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.13
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Octopize Avatar Deployment Tool
+
+Automated configuration tool for deploying Octopize Avatar platform using Docker Compose.
+
+## Quick Start
+
+```bash
+# Install
+pip install octopize-avatar-deploy
+
+# Run interactive configuration
+octopize-avatar-deploy --output-dir /app/avatar
+
+# Deploy
+cd /app/avatar
+docker compose down --volumes --remove-orphans  # Clean old containers if redeploying
+docker compose up -d
+```
+
+## Usage Options
+
+### Interactive Mode (Default)
+
+```bash
+octopize-avatar-deploy --output-dir /app/avatar
+```
+
+### Non-Interactive Mode
+
+```bash
+# Create config file
+cat > config.yaml << EOF
+PUBLIC_URL: avatar.example.com
+ENV_NAME: prod
+ORGANIZATION_NAME: MyCompany
+EOF
+
+# Run with config
+octopize-avatar-deploy --output-dir /app/avatar --config config.yaml --non-interactive
+```
+
+## Command Line Options
+
+```
+--output-dir DIR           Output directory (default: current directory)
+--config FILE              YAML configuration file
+--non-interactive          Non-interactive mode (requires config file)
+--template-from PATH       Use local templates instead of downloading from GitHub
+--save-config              Save configuration to deployment-config.yaml
+--verbose                  Show detailed output
+```
+
+## What Gets Generated
+
+```
+/app/avatar/
+├── .env                            # Environment configuration
+├── docker-compose.yml              # Docker services
+├── nginx/nginx.conf                # Nginx config
+├── authentik/
+│   ├── octopize-avatar-blueprint.yaml
+│   ├── custom-templates/           # Email templates
+│   └── branding/                   # Logo, favicon, background
+└── .secrets/                       # Generated secrets (22 files)
+```
+
+## Deployment Steps
+
+1. **Generate configuration:**
+
+   ```bash
+   octopize-avatar-deploy --output-dir /app/avatar
+   ```
+
+2. **Review generated files:**
+
+   ```bash
+   cd /app/avatar
+   cat .env
+   ls -la .secrets/
+   ```
+
+3. **Add TLS certificates (production):**
+
+   ```bash
+   mkdir -p tls
+   cp /path/to/fullchain.pem tls/
+   cp /path/to/privkey.pem tls/
+   ```
+
+4. **Start services:**
+
+   ```bash
+   docker compose down --volumes --remove-orphans
+   docker compose up -d
+   ```
+
+5. **Verify deployment:**
+
+   ```bash
+   docker compose ps
+   docker compose logs -f
+   curl https://avatar.example.com/api/health
+   ```
+
+## Troubleshooting
+
+### "bind source path does not exist" error
+
+Old containers from previous deployment. Solution:
+
+```bash
+docker compose down --volumes --remove-orphans
+docker compose up -d
+```
+
+### Templates not downloading
+
+```bash
+rm -rf .avatar-templates/
+octopize-avatar-deploy --output-dir /app/avatar --verbose
+```
+
+## Development
+
+```bash
+# Clone
+git clone https://github.com/octopize/avatar-deployment
+cd avatar-deployment/deployment-tool
+
+# Install dependencies
+just install
+
+# Run tests
+just test-all
+
+# Run locally
+just run-interactive-local
+```

{octopize_deploy_tool-0.1.0.dist-info → octopize_deploy_tool-0.3.0.dist-info}/RECORD

@@ -1,12 +1,12 @@
 octopize_avatar_deploy/__init__.py,sha256=5RK4GI9PpEGMfABm3nZ2rEDyohQ0W_Hvn_cHQBBnAsw,651
 octopize_avatar_deploy/cli_test_harness.py,sha256=wIMKQ3VPuJDg6LVQcJVQA8WYbKOEwNwUPBD2swl5WkU,6703
-octopize_avatar_deploy/configure.py,sha256=BTyX0gzp-L3XpCR81VsCS5oubv6m57ltwqf7pUFVyks,24657
-octopize_avatar_deploy/defaults.yaml,sha256=-64srbym-Ex_kPCFq6DkZet8icBCkjadOrycEDAQUas,1649
-octopize_avatar_deploy/download_templates.py,sha256=x5ylpv1TfgbHga2AM1qZpJYrT8PxNlL2bLMj9tCsxJA,7152
+octopize_avatar_deploy/configure.py,sha256=BnNFFVAmA64gCV1df9bVpL3QM5xBMCB_mIOBGn-Zqls,26174
+octopize_avatar_deploy/defaults.yaml,sha256=sZWjUOza8XXYTT7m2mcUWADXHaFqefH_jv50ySpWBX0,1144
+octopize_avatar_deploy/download_templates.py,sha256=86oG4356rciqbEzmJSjHhwUEt0MZhKA4FBPUQbzWL2U,10797
 octopize_avatar_deploy/input_gatherer.py,sha256=HztvV1_nK2ZWjtZWVoQcwQNjAtJbPJT0dDQ5l_GpSWU,11287
 octopize_avatar_deploy/printer.py,sha256=3MdaL_eXk283z7BmZM94buvYeGfEvE9hAgaBgq0MoNs,6659
-octopize_avatar_deploy/state_manager.py,sha256=dEZF8pSifHdlyF8_YNQLzXPpFFSx5fDk4hhUcKJHuxA,4893
-octopize_avatar_deploy/version_compat.py,sha256=0TlsBr7zWUD9TsTuNpLkKmshrbWpyPb1pL1Z0MKtqlc,10559
+octopize_avatar_deploy/state_manager.py,sha256=3IstFyh-esorqmxOx0Bie6z3gAtHNolSlcJa0knUZSE,5090
+octopize_avatar_deploy/version_compat.py,sha256=kgtU-344Sas9c3vXX2_fm1ZW0XI5i-KWO7v_fVsswEk,10559
 octopize_avatar_deploy/steps/__init__.py,sha256=bITxXeDG9bvAyJ4EGUESb_uX0UTLHou98Jd8TjBrO_o,626
 octopize_avatar_deploy/steps/authentik.py,sha256=6iSJUb18GRmz0SRYR0VzZGqPmhFRV1YZb1M9kS5XUUk,1460
 octopize_avatar_deploy/steps/authentik_blueprint.py,sha256=fWM7F9V2gCv7Lq9vRE4YKdOfD4Bw7PTn8Iakc8FkMpw,2786
@@ -14,11 +14,11 @@ octopize_avatar_deploy/steps/base.py,sha256=91Ph8bGJRFa2ceKrpXlN3IOsFEX2F7hR3p6t
 octopize_avatar_deploy/steps/database.py,sha256=9-RKxz0h2HdTSJyPdoW3iQ6veHVLH8aSfKxiAGUsqU4,1182
 octopize_avatar_deploy/steps/email.py,sha256=9yz9qx7vBSt8Dfg-7CZ3yM2kfIoWimyyUyiGmAUP7LQ,3139
 octopize_avatar_deploy/steps/logging.py,sha256=ks10nx0Mf0ZX9lygdIG4zoWFmAupJ528DbDRGM-PQnU,856
-octopize_avatar_deploy/steps/required.py,sha256=cKAZsgmtNJ7xQ9txza3TaJ1e562iTJpg5MsjK7US9Kk,3103
+octopize_avatar_deploy/steps/required.py,sha256=08xxCDpMwYiKCSq4rlQhWEiF0aoZCAPatIF_x-o4Ecs,3309
 octopize_avatar_deploy/steps/storage.py,sha256=4-GVz8cMFY_fP4m1XR0yakGXfqpAGT3ZCY-lGB2uBG4,972
-octopize_avatar_deploy/steps/telemetry.py,sha256=Xo5sNDROBJGeZyLzum6aYCCYovebbNQvxeQVmILp54A,1878
+octopize_avatar_deploy/steps/telemetry.py,sha256=9ikriAzn0OJr4zxW-saYfvhW4GJp0WDomtzhOQU7yb8,1880
 octopize_avatar_deploy/steps/user.py,sha256=3FSeEVjTHFieLGN2PqUwKzwIqe4vcx5eTw651Vg66ug,2825
-octopize_deploy_tool-0.1.0.dist-info/METADATA,sha256=C3w4-GaxFR59B7VGxnaTcLsnfLA_jR57fc89Yq4GVK0,9502
-octopize_deploy_tool-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-octopize_deploy_tool-0.1.0.dist-info/entry_points.txt,sha256=owTMr4VgBceyp-KPS3f4CEsiKkVQJAx84PRpjS8G5cw,81
-octopize_deploy_tool-0.1.0.dist-info/RECORD,,
+octopize_deploy_tool-0.3.0.dist-info/METADATA,sha256=nuRD0VPZss-GpL8qO0z6zXBfX6kLaHdTP48tX06FG38,4113
+octopize_deploy_tool-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+octopize_deploy_tool-0.3.0.dist-info/entry_points.txt,sha256=A0f3VrMyKxoPfL_jsk7VnQUy5NbbC9r1pe-y9zczPDQ,79
+octopize_deploy_tool-0.3.0.dist-info/RECORD,,

octopize_deploy_tool-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+octopize-deploy-tool = octopize_avatar_deploy.configure:main

octopize_deploy_tool-0.1.0.dist-info/METADATA

@@ -1,346 +0,0 @@
-Metadata-Version: 2.4
-Name: octopize.deploy_tool
-Version: 0.1.0
-Summary: Deployment configuration tool for Octopize Avatar platform
-Project-URL: Homepage, https://octopize.io
-Project-URL: Documentation, https://docs.octopize.io/docs/deploying/self-hosted
-Project-URL: Repository, https://github.com/octopize/avatar-deployment
-Project-URL: Issues, https://github.com/octopize/avatar-deployment/issues
-Author-email: Octopize <contact@octopize.io>
-License: MIT
-Keywords: avatar,configuration,deployment,octopize
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: System :: Installation/Setup
-Classifier: Topic :: System :: Systems Administration
-Requires-Python: >=3.13
-Requires-Dist: jinja2>=3.1.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: rich>=13.0.0
-Provides-Extra: dev
-Requires-Dist: mypy; extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
-Requires-Dist: ruff>=0.1.0; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# Octopize Avatar Deployment Tool
-
-Automated configuration tool for deploying Octopize Avatar platform using Docker Compose.
-
-## Overview
-
-This tool simplifies Avatar deployment by:
-- **📦 Standalone package** - No need to clone the entire repository
-- **⬇️ Downloads templates** automatically from GitHub
-- **🎯 Deployment presets** - dev-mode, production, airgapped configurations
-- **🔐 Secure secrets generation** - Automatic creation of encryption keys
-- **✅ Stateless by design** - Minimal bundled dependencies
-- **🔄 Resumable configuration** - State management for interrupted setups
-
-## Architecture
-
-### What's Bundled vs Downloaded
-
-**Bundled in PyPI Package:**
-- `configure.py` - Main configuration logic
-- `state_manager.py` - State management for resuming
-- `download_templates.py` - Template downloader
-- `defaults.yaml` - Default values and presets
-
-**Downloaded from GitHub (on-demand):**
-- `.env.template` - Environment configuration template
-- `nginx.conf.template` - Nginx configuration template
-- `docker-compose.yml` - Docker services definition
-- `.template-version` - Template version information
-- Other deployment files
-
-These templates are located in `docker/templates/` in the avatar-deployment repository.
-
-This design means you can install and run the tool without cloning the repository!
-
-## Quick Start
-
-### Option 1: Using uvx (Recommended - After PyPI Publication)
-
-```bash
-uvx octopize-avatar-deploy --output-dir /app/avatar
-```
-
-### Option 2: Using pip
-
-```bash
-pip install octopize-avatar-deploy
-octopize-avatar-deploy --output-dir /app/avatar
-```
-
-### Option 3: From Source with uv
-
-```bash
-# Sparse clone (only deployment-tool directory)
-git clone --depth 1 --filter=blob:none --sparse https://github.com/octopize/avatar-deployment
-cd avatar-deployment
-git sparse-checkout set deployment-tool
-
-# Run with uv
-cd deployment-tool
-uv run configure.py --output-dir /app/avatar
-```
-
-## Deployment Presets
-
-Choose a preset to quickly configure for your environment:
-
-### `default` - Production Configuration
-- Console logging: **disabled** (use structured logs)
-- Sentry monitoring: **enabled**
-- Telemetry: **enabled**
-- Best for: Production deployments with monitoring
-
-### `dev-mode` - Development Configuration  
-- Console logging: **enabled** (see logs in terminal)
-- Sentry monitoring: **disabled**
-- Telemetry: **disabled**
-- Best for: Local development and testing
-
-### `airgapped` - Air-Gapped Deployment
-- Console logging: **disabled**
-- Sentry monitoring: **disabled** (no external connections)
-- Telemetry: **disabled** (no external connections)
-- Best for: Secure, isolated environments
-
-### `custom` - Manual Configuration
-- Configure all options interactively
-- Best for: Specific requirements
-
-## Usage
-
-### Interactive Mode with Preset
-
-```bash
-octopize-avatar-deploy --output-dir /app/avatar --preset dev-mode
-```
-
-The tool will:
-1. Download latest templates from GitHub
-2. Apply preset configuration
-3. Prompt for required values (PUBLIC_URL, ENV_NAME)
-4. Generate configuration files
-
-### Non-Interactive Mode
-
-```bash
-# Create config file
-cat > my-config.yaml << EOF
-PUBLIC_URL: avatar.mycompany.com
-ENV_NAME: mycompany-prod
-AVATAR_API_VERSION: 2.20.1
-AVATAR_WEB_VERSION: 0.40.0
-MAIL_PROVIDER: smtp
-SMTP_HOST: mail.mycompany.com
-EOF
-
-# Run with config
-octopize-avatar-deploy \
-  --config my-config.yaml \
-  --preset default \
-  --non-interactive \
-  --output-dir /app/avatar
-```
-
-### Advanced Options
-
-```bash
-octopize-avatar-deploy \
-  --output-dir /app/avatar \
-  --preset dev-mode \
-  --download-branch main \          # Git branch to download from
-  --skip-download \                 # Use cached templates
-  --save-config \                   # Save config to deployment-config.yaml
-  --verbose                         # Show detailed progress
-```
-
-## Command Line Options
-
-```
---output-dir DIR           Output directory (default: current directory)
---preset NAME              Use preset: default, dev-mode, airgapped
---config FILE              YAML configuration file
---non-interactive          Non-interactive mode (use config/defaults)
---auth-type TYPE           Authentication: email or username (default: email)
---save-config              Save config to deployment-config.yaml
---download-branch BRANCH   Git branch for templates (default: main)
---skip-download            Use cached templates
---verbose                  Detailed output
-```
-
-## What Gets Generated
-
-After running the tool, you'll have:
-
-```
-/app/avatar/
-├── .env                      # Environment configuration
-├── nginx.conf                # Nginx reverse proxy config
-├── .secrets/                 # Generated secrets (gitignored)
-│   ├── db_password
-│   ├── authentik_secret_key
-│   ├── avatar_api_encryption_key
-│   └── ...
-├── docker-compose.yml        # Downloaded from GitHub
-└── .avatar-templates/        # Cached templates (auto-downloaded)
-    ├── .env.template
-    ├── nginx.conf.template
-    ├── docker-compose.yml
-    └── .template-version
-```
-
-## Configuration Presets in Detail
-
-Presets are defined in `defaults.yaml`:
-
-```yaml
-presets:
-  default:
-    description: "Production-ready with telemetry and monitoring"
-    application:
-      use_console_logging: "false"
-      sentry_enabled: "true"
-    telemetry:
-      enabled: true
-  
-  dev-mode:
-    description: "Development with console logging"
-    application:
-      use_console_logging: "true"
-      sentry_enabled: "false"
-    telemetry:
-      enabled: false
-  
-  airgapped:
-    description: "No external monitoring/telemetry"
-    application:
-      use_console_logging: "false"
-      sentry_enabled: "false"
-    telemetry:
-      enabled: false
-```
-
-You can override preset values during interactive configuration.
-
-## Template Download Mechanism
-
-Templates are downloaded from GitHub on first run:
-
-1. **Check cache** - `.avatar-templates/` directory
-2. **Download if needed** - From `github.com/octopize/avatar-deployment`
-3. **Use cached** - On subsequent runs (unless `--skip-download` is used)
-
-This ensures:
-- ✅ Always get latest templates (from specified branch)
-- ✅ Offline support (once cached)
-- ✅ No repository cloning required
-- ✅ Minimal package size
-
-## State Management
-
-The tool saves progress to `.deployment-state.yaml` allowing you to:
-
-- **Resume interrupted configurations**
-- **Track which steps completed**
-- **Avoid re-entering values**
-
-Steps:
-1. Collect required config
-2. Collect optional config
-3. Generate .env file
-4. Generate nginx.conf
-5. Generate secrets
-6. Prompt for user secrets (optional)
-7. Finalize
-
-```bash
-# If interrupted, just run again:
-octopize-avatar-deploy --output-dir /app/avatar
-
-# Tool will ask: "Continue from where you left off? [Y/n]"
-```
-
-## Troubleshooting
-
-### Templates not downloading
-
-```bash
-# Force re-download
-rm -rf .avatar-templates/
-octopize-avatar-deploy --output-dir /app/avatar --verbose
-```
-
-### Use specific Git branch
-
-```bash
-# Download from development branch
-octopize-avatar-deploy \
-  --output-dir /app/avatar \
-  --download-branch develop \
-  --verbose
-```
-
-### Offline mode
-
-```bash
-# Download templates once
-octopize-avatar-deploy --output-dir /app/avatar
-
-# Then use cached versions
-octopize-avatar-deploy --output-dir /app/avatar --skip-download
-```
-
-## Development
-
-### Project Structure
-
-```
-deployment-tool/
-├── configure.py           # Main script (bundled)
-├── state_manager.py       # State management (bundled)
-├── download_templates.py  # Template downloader (bundled)
-├── defaults.yaml          # Defaults and presets (bundled)
-├── tests/                 # Test suite
-├── README.md             
-└── pyproject.toml         # Package configuration
-```
-
-### Running Tests
-
-```bash
-cd deployment-tool
-pytest tests/
-```
-
-### Building Package
-
-```bash
-pip install build
-python -m build
-```
-
-## Related Documentation
-
-- [Deployment Guide](../deploying-on-single-instance.md)
-- [Docker Compose Configuration](../docker-compose.yml)
-- [Migration Guide](../MIGRATION_GUIDE.md)
-
-## Support
-
-For issues and questions:
-- Email: help@octopize.io
-- Documentation: https://docs.octopize.io
-- Repository: https://github.com/octopize/avatar-deployment
-
-## License
-
-Apache License v2.0

octopize_deploy_tool-0.1.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-octopize-avatar-deploy = octopize_avatar_deploy.configure:main