clonebox 0.1.20__py3-none-any.whl → 0.1.21__py3-none-any.whl

clonebox/cli.py

@@ -653,6 +653,7 @@ def interactive_mode():
     summary_table.add_row("Name", vm_name)
     summary_table.add_row("RAM", f"{ram_mb} MB")
     summary_table.add_row("vCPUs", str(vcpus))
+    summary_table.add_row("Disk", f"{20 if enable_gui else 10} GB")
     summary_table.add_row("Services", ", ".join(selected_services) or "None")
     summary_table.add_row(
         "Packages",
@@ -684,6 +685,7 @@ def interactive_mode():
         name=vm_name,
         ram_mb=ram_mb,
         vcpus=vcpus,
+        disk_size_gb=20 if enable_gui else 10,
         gui=enable_gui,
         base_image=base_image if base_image else None,
         paths=paths_mapping,
@@ -732,6 +734,7 @@ def cmd_create(args):
         name=args.name,
         ram_mb=args.ram,
         vcpus=args.vcpus,
+        disk_size_gb=getattr(args, "disk_size_gb", 10),
         gui=not args.no_gui,
         base_image=args.base_image,
         paths=config_data.get("paths", {}),
@@ -1708,6 +1711,7 @@ def generate_clonebox_yaml(
     vm_name: str = None,
     network_mode: str = "auto",
     base_image: Optional[str] = None,
+    disk_size_gb: Optional[int] = None,
 ) -> str:
     """Generate YAML config from system snapshot."""
     sys_info = detector.get_system_info()
@@ -1813,6 +1817,9 @@ def generate_clonebox_yaml(
     ram_mb = min(4096, int(sys_info["memory_available_gb"] * 1024 * 0.5))
     vcpus = max(2, sys_info["cpu_count"] // 2)
 
+    if disk_size_gb is None:
+        disk_size_gb = 20
+
     # Auto-detect packages from running applications and services
     app_packages = detector.suggest_packages_for_apps(snapshot.applications)
     service_packages = detector.suggest_packages_for_services(snapshot.running_services)
@@ -1871,6 +1878,7 @@ def generate_clonebox_yaml(
             "name": vm_name,
             "ram_mb": ram_mb,
             "vcpus": vcpus,
+            "disk_size_gb": disk_size_gb,
             "gui": True,
             "base_image": base_image,
             "network_mode": network_mode,
@@ -2024,6 +2032,7 @@ def create_vm_from_config(
         name=config["vm"]["name"],
         ram_mb=config["vm"].get("ram_mb", 4096),
         vcpus=config["vm"].get("vcpus", 4),
+        disk_size_gb=config["vm"].get("disk_size_gb", 10),
         gui=config["vm"].get("gui", True),
         base_image=config["vm"].get("base_image"),
         paths=all_paths,
@@ -2103,6 +2112,7 @@ def cmd_clone(args):
         vm_name=vm_name,
         network_mode=args.network,
         base_image=getattr(args, "base_image", None),
+        disk_size_gb=getattr(args, "disk_size_gb", None),
     )
 
     profile_name = getattr(args, "profile", None)
@@ -2345,6 +2355,12 @@ def main():
     )
     create_parser.add_argument("--ram", type=int, default=4096, help="RAM in MB")
     create_parser.add_argument("--vcpus", type=int, default=4, help="Number of vCPUs")
+    create_parser.add_argument(
+        "--disk-size-gb",
+        type=int,
+        default=10,
+        help="Root disk size in GB (default: 10)",
+    )
     create_parser.add_argument("--base-image", help="Path to base qcow2 image")
     create_parser.add_argument("--no-gui", action="store_true", help="Disable SPICE graphics")
     create_parser.add_argument("--start", "-s", action="store_true", help="Start VM after creation")
@@ -2551,6 +2567,12 @@ def main():
         "--base-image",
         help="Path to a bootable qcow2 image to use as a base disk",
     )
+    clone_parser.add_argument(
+        "--disk-size-gb",
+        type=int,
+        default=None,
+        help="Root disk size in GB (default: 20 for generated configs)",
+    )
     clone_parser.add_argument(
         "--profile",
         help="Profile name (loads ~/.clonebox.d/<name>.yaml, .clonebox.d/<name>.yaml, or built-in templates)",

clonebox/cloner.py

@@ -18,6 +18,16 @@ try:
 except ImportError:
     libvirt = None
 
+SNAP_INTERFACES = {
+    'pycharm-community': ['desktop', 'desktop-legacy', 'x11', 'wayland', 'home', 'network', 'network-bind', 'cups-control', 'removable-media'],
+    'chromium': ['desktop', 'desktop-legacy', 'x11', 'wayland', 'home', 'network', 'audio-playback', 'camera'],
+    'firefox': ['desktop', 'desktop-legacy', 'x11', 'wayland', 'home', 'network', 'audio-playback', 'removable-media'],
+    'code': ['desktop', 'desktop-legacy', 'x11', 'wayland', 'home', 'network', 'ssh-keys'],
+    'slack': ['desktop', 'desktop-legacy', 'x11', 'wayland', 'home', 'network', 'audio-playback'],
+    'spotify': ['desktop', 'x11', 'wayland', 'home', 'network', 'audio-playback'],
+}
+DEFAULT_SNAP_INTERFACES = ['desktop', 'desktop-legacy', 'x11', 'home', 'network']
+
 
 @dataclass
 class VMConfig:
@@ -26,7 +36,7 @@ class VMConfig:
     name: str = "clonebox-vm"
     ram_mb: int = 4096
     vcpus: int = 4
-    disk_size_gb: int = 10
+    disk_size_gb: int = 20
     gui: bool = True
     base_image: Optional[str] = None
     paths: dict = field(default_factory=dict)
@@ -680,7 +690,7 @@ fi
 
         # User-data
         # Add desktop environment if GUI is enabled
-        base_packages = ["qemu-guest-agent"]
+        base_packages = ["qemu-guest-agent", "cloud-guest-utils"]
         if config.gui:
             base_packages.extend([
                 "ubuntu-desktop-minimal",
@@ -719,6 +729,15 @@ fi
             runcmd_lines.append("  - echo 'Installing snap packages...'")
             for snap_pkg in config.snap_packages:
                 runcmd_lines.append(f"  - snap install {snap_pkg} --classic || snap install {snap_pkg} || true")
+            
+            # Connect snap interfaces for GUI apps (not auto-connected via cloud-init)
+            runcmd_lines.append("  - echo 'Connecting snap interfaces...'")
+            for snap_pkg in config.snap_packages:
+                interfaces = SNAP_INTERFACES.get(snap_pkg, DEFAULT_SNAP_INTERFACES)
+                for iface in interfaces:
+                    runcmd_lines.append(f"  - snap connect {snap_pkg}:{iface} :{iface} 2>/dev/null || true")
+
+            runcmd_lines.append("  - systemctl restart snapd || true")
         
         # Add GUI setup if enabled - runs AFTER package installation completes
         if config.gui:
@@ -770,6 +789,13 @@ ssh_pwauth: true
 chpasswd:
   expire: false
 
+# Make sure root partition + filesystem grows to fill the qcow2 disk size
+growpart:
+  mode: auto
+  devices: ["/"]
+  ignore_growroot_disabled: false
+resize_rootfs: true
+
 # Update package cache and upgrade
 package_update: true
 package_upgrade: false

clonebox/models.py

@@ -16,7 +16,7 @@ class VMSettings(BaseModel):
     name: str = Field(default="clonebox-vm", description="VM name")
     ram_mb: int = Field(default=4096, ge=512, le=131072, description="RAM in MB")
     vcpus: int = Field(default=4, ge=1, le=128, description="Number of vCPUs")
-    disk_size_gb: int = Field(default=10, ge=1, le=2048, description="Disk size in GB")
+    disk_size_gb: int = Field(default=20, ge=1, le=2048, description="Disk size in GB")
     gui: bool = Field(default=True, description="Enable SPICE graphics")
     base_image: Optional[str] = Field(default=None, description="Path to base qcow2 image")
     network_mode: str = Field(default="auto", description="Network mode: auto|default|user")
@@ -107,6 +107,10 @@ class CloneBoxConfig(BaseModel):
         """Convert to legacy VMConfig dataclass for compatibility."""
         from clonebox.cloner import VMConfig as VMConfigDataclass
 
+        # Merge paths and app_data_paths
+        all_paths = dict(self.paths)
+        all_paths.update(self.app_data_paths)
+
         return VMConfigDataclass(
             name=self.vm.name,
             ram_mb=self.vm.ram_mb,
@@ -114,7 +118,7 @@ class CloneBoxConfig(BaseModel):
             disk_size_gb=self.vm.disk_size_gb,
             gui=self.vm.gui,
             base_image=self.vm.base_image,
-            paths=self.paths,
+            paths=all_paths,
             packages=self.packages,
             snap_packages=self.snap_packages,
             services=self.services,

{clonebox-0.1.20.dist-info → clonebox-0.1.21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clonebox
-Version: 0.1.20
+Version: 0.1.21
 Summary: Clone your workstation environment to an isolated VM with selective apps, paths and services
 Author: CloneBox Team
 License: Apache-2.0
@@ -85,6 +85,22 @@ CloneBox lets you create isolated virtual machines with only the applications, d
 - 🧪 **Configuration testing** - Validate VM settings and functionality
 - 📁 **App data sync** - Include browser profiles, IDE settings, and app configs
 
+## Use Cases
+
+CloneBox excels in scenarios where developers need:
+- Isolated sandbox environments for testing AI agents, edge computing simulations, or integration workflows without risking host system stability
+- Reproducible development setups that can be quickly spun up with identical configurations across different machines
+- Safe experimentation with system-level changes that can be discarded by simply deleting the VM
+- Quick onboarding for new team members who need a fully configured development environment
+
+## What's Next
+
+Project roadmap includes:
+- Container runtime integration (Podman/Docker lightweight mode)
+- Local dashboard for VM and container management
+- Profile system for reusable configuration presets
+- Proxmox export capabilities for production migration
+
 
 
 
@@ -95,6 +111,8 @@ Kluczowe komendy:
 - `clonebox` – interaktywny wizard (detect + create + start)
 - `clonebox detect` – skanuje usługi/apps/ścieżki
 - `clonebox clone . --user --run` – szybki klon bieżącego katalogu z użytkownikiem i autostartem
+- `clonebox container up|ps|stop|rm` – lekki runtime kontenerowy (podman/docker)
+- `clonebox dashboard` – lokalny dashboard (VM + containers)
 
 ### Dlaczego wirtualne klony workstation mają sens?
 
@@ -167,6 +185,11 @@ pip install -e .
 # Or directly
 pip install clonebox
 ```
+
+Dashboard ma opcjonalne zależności:
+```bash
+pip install "clonebox[dashboard]"
+```
 lub
 ```bash
 # Aktywuj venv
@@ -247,7 +270,34 @@ Simply run `clonebox` to start the interactive wizard:
 
 ```bash
 clonebox
-clonebox clone . --user --run --replace --base-image ~/ubuntu-22.04-cloud.qcow2
+
+clonebox clone . --user --run --replace --base-image ~/ubuntu-22.04-cloud.qcow2 --disk-size-gb 30
+
+clonebox test . --user --validate
+```
+
+### Profiles (Reusable presets)
+
+Profiles pozwalają trzymać gotowe presety dla VM/container (np. `ml-dev`, `web-dev`) i nakładać je na bazową konfigurację.
+
+```bash
+# Przykład: uruchom kontener z profilem
+clonebox container up . --profile ml-dev --engine podman
+
+# Przykład: generuj VM config z profilem
+clonebox clone . --profile ml-dev --user --run
+```
+
+Domyślne lokalizacje profili:
+- `~/.clonebox.d/<name>.yaml`
+- `./.clonebox.d/<name>.yaml`
+- wbudowane: `src/clonebox/templates/profiles/<name>.yaml`
+
+### Dashboard
+
+```bash
+clonebox dashboard --port 8080
+# http://127.0.0.1:8080
 ```
 
 The wizard will:
@@ -268,7 +318,10 @@ clonebox create --name my-dev-vm --config '{
   },
   "packages": ["python3", "nodejs", "docker.io"],
   "services": ["docker"]
-}' --ram 4096 --vcpus 4 --start
+}' --ram 4096 --vcpus 4 --disk-size-gb 20 --start
+
+# Create VM with larger root disk
+clonebox create --name my-dev-vm --disk-size-gb 30 --config '{"paths": {}, "packages": [], "services": []}'
 
 # List VMs
 clonebox list
@@ -325,10 +378,45 @@ clonebox clone . --user --run
 
 # Access in VM:
 ls ~/.config/google-chrome  # Chrome profile
-ls ~/.mozilla/firefox       # Firefox profile
-ls ~/.config/JetBrains      # PyCharm settings
+
+# Firefox profile (Ubuntu często używa snap):
+ls ~/snap/firefox/common/.mozilla/firefox
+ls ~/.mozilla/firefox
+
+# PyCharm profile (snap):
+ls ~/snap/pycharm-community/common/.config/JetBrains
+ls ~/.config/JetBrains
+```
+
+### Container workflow (podman/docker)
+
+```bash
+# Start a dev container (auto-detect engine if not specified)
+clonebox container up . --engine podman --detach
+
+# List running containers
+clonebox container ps
+
+# Stop/remove
+clonebox container stop <name>
+clonebox container rm <name>
+```
+
+### Full validation (VM)
+
+`clonebox test` weryfikuje, że VM faktycznie ma zamontowane ścieżki i spełnia wymagania z `.clonebox.yaml`.
+
+```bash
+clonebox test . --user --validate
 ```
 
+Walidowane kategorie:
+- **Mounts** (9p)
+- **Packages** (apt)
+- **Snap packages**
+- **Services** (enabled + running)
+- **Apps** (instalacja + dostępność profilu: Firefox/PyCharm/Chrome)
+
 ### Testing and Validating VM Configuration
 
 ```bash
@@ -557,6 +645,9 @@ The fastest way to clone your current working directory:
 # Base OS image is automatically downloaded to ~/Downloads on first run
 clonebox clone .
 
+# Increase VM disk size (recommended for GUI + large tooling)
+clonebox clone . --user --disk-size-gb 30
+
 # Clone specific path
 clonebox clone ~/projects/my-app
 
@@ -687,8 +778,10 @@ clonebox clone . --network auto
 | `clonebox clone . --replace` | Replace existing VM (stop, delete, recreate) |
 | `clonebox clone . --user` | Clone in user session (no root) |
 | `clonebox clone . --base-image <path>` | Use custom base image |
+| `clonebox clone . --disk-size-gb <gb>` | Set root disk size in GB (generated configs default to 20GB) |
 | `clonebox clone . --network user` | Use user-mode networking (slirp) |
 | `clonebox clone . --network auto` | Auto-detect network mode (default) |
+| `clonebox create --config <json> --disk-size-gb <gb>` | Create VM from JSON config with specified disk size |
 | `clonebox start .` | Start VM from `.clonebox.yaml` in current dir |
 | `clonebox start . --viewer` | Start VM and open GUI window |
 | `clonebox start <name>` | Start existing VM by name |
@@ -701,6 +794,11 @@ clonebox clone . --network auto
 | `clonebox detect --yaml` | Output as YAML config |
 | `clonebox detect --yaml --dedupe` | YAML with duplicates removed |
 | `clonebox detect --json` | Output as JSON |
+| `clonebox container up .` | Start a dev container for given path |
+| `clonebox container ps` | List containers |
+| `clonebox container stop <name>` | Stop a container |
+| `clonebox container rm <name>` | Remove a container |
+| `clonebox dashboard` | Run local dashboard (VM + containers) |
 | `clonebox status . --user` | Check VM health, cloud-init, IP, and mount status |
 | `clonebox status . --user --health` | Check VM status and run full health check |
 | `clonebox test . --user` | Test VM configuration (basic checks) |
@@ -721,6 +819,97 @@ clonebox clone . --network auto
 
 ## Troubleshooting
 
+### Critical: Insufficient Disk Space
+
+If you install a full desktop environment and large development tools (e.g. `ubuntu-desktop-minimal`, `docker.io`, large snaps like `pycharm-community`/`chromium`), you may hit low disk space warnings inside the VM.
+
+Recommended fix:
+- Set a larger root disk in `.clonebox.yaml`:
+
+```yaml
+vm:
+  disk_size_gb: 30
+```
+
+You can also set it during config generation:
+```bash
+clonebox clone . --user --disk-size-gb 30
+```
+
+Notes:
+- New configs generated by `clonebox clone` default to `disk_size_gb: 20`.
+- You can override this by setting `vm.disk_size_gb` in `.clonebox.yaml`.
+
+Workaround for an existing VM (host-side resize + guest filesystem grow):
+```bash
+clonebox stop . --user
+qemu-img resize ~/.local/share/libvirt/images/<vm-name>/root.qcow2 +10G
+clonebox start . --user
+```
+
+Inside the VM:
+```bash
+sudo growpart /dev/vda 1
+sudo resize2fs /dev/vda1
+df -h /
+```
+
+### Known Issue: IBus Preferences crash
+
+During validation you may occasionally see a crash dialog from **IBus Preferences** in the Ubuntu desktop environment.
+This is an upstream issue related to the input method daemon (`ibus-daemon`) and obsolete system packages (e.g. `libglib2.0`, `libssl3`, `libxml2`, `openssl`).
+It does **not** affect CloneBox functionality and the VM operates normally.
+
+Workaround:
+- Dismiss the crash dialog
+- Or run `sudo apt upgrade` inside the VM to update system packages
+
+### Snap Apps Not Launching (PyCharm, Chromium, Firefox)
+
+If snap-installed applications (e.g., PyCharm, Chromium) are installed but don't launch when clicked, the issue is usually **disconnected snap interfaces**. This happens because snap interfaces are not auto-connected when installing via cloud-init.
+
+**New VMs created with updated CloneBox automatically connect snap interfaces**, but for older VMs or manual installs:
+
+```bash
+# Check snap interface connections
+snap connections pycharm-community
+
+# If you see "-" instead of ":desktop", interfaces are NOT connected
+
+# Connect required interfaces
+sudo snap connect pycharm-community:desktop :desktop
+sudo snap connect pycharm-community:desktop-legacy :desktop-legacy
+sudo snap connect pycharm-community:x11 :x11
+sudo snap connect pycharm-community:wayland :wayland
+sudo snap connect pycharm-community:home :home
+sudo snap connect pycharm-community:network :network
+
+# Restart snap daemon and try again
+sudo systemctl restart snapd
+snap run pycharm-community
+```
+
+**For Chromium/Firefox:**
+```bash
+sudo snap connect chromium:desktop :desktop
+sudo snap connect chromium:x11 :x11
+sudo snap connect firefox:desktop :desktop
+sudo snap connect firefox:x11 :x11
+```
+
+**Debug launch:**
+```bash
+PYCHARM_DEBUG=true snap run pycharm-community 2>&1 | tee /tmp/pycharm-debug.log
+```
+
+**Nuclear option (reinstall):**
+```bash
+snap remove pycharm-community
+rm -rf ~/snap/pycharm-community
+sudo snap install pycharm-community --classic
+sudo snap connect pycharm-community:desktop :desktop
+```
+
 ### Network Issues
 
 If you encounter "Network not found" or "network 'default' is not active" errors:
@@ -1069,4 +1258,4 @@ qm set 9000 --boot c --bootdisk scsi0
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file.
+Apache License - see [LICENSE](LICENSE) file.

{clonebox-0.1.20.dist-info → clonebox-0.1.21.dist-info}/RECORD

@@ -1,17 +1,17 @@
 clonebox/__init__.py,sha256=CyfHVVq6KqBr4CNERBpXk_O6Q5B35q03YpdQbokVvvI,408
 clonebox/__main__.py,sha256=Fcoyzwwyz5-eC_sBlQk5a5RbKx8uodQz5sKJ190U0NU,135
-clonebox/cli.py,sha256=08k0XvVdcExl6M64jqt7I_E04QVES3opXPexX9bYJec,103621
-clonebox/cloner.py,sha256=_dJrcg4FoPzAU49J-duJdp37GF-5hE3R_ipbwaw-kaQ,32679
+clonebox/cli.py,sha256=ItXPNJmQeWbv-Bf9IxYi4e6AsX04pJwRk8fBXP0MglA,104376
+clonebox/cloner.py,sha256=jR-pIBewc8zNE_h_sTcID1uZYKeQjNc6VInhE3aikfQ,34156
 clonebox/container.py,sha256=tiYK1ZB-DhdD6A2FuMA0h_sRNkUI7KfYcJ0tFOcdyeM,6105
 clonebox/dashboard.py,sha256=RhSPvR6kWglqXeLkCWesBZQid7wv2WpJa6w78mXbPjY,4268
 clonebox/detector.py,sha256=aS_QlbG93-DE3hsjRt88E7O-PGC2TUBgUbP9wqT9g60,23221
-clonebox/models.py,sha256=Uxz9eHov2epJpNYbl0ejaOX91iMSjqdHskGdC8-smVk,7789
+clonebox/models.py,sha256=yBRUlJejpeJHZjvCYMGq1nXPFcmhLFxN-LqkEyveWsA,7913
 clonebox/profiles.py,sha256=VaKVuxCrgyMxx-8_WOTcw7E8irwGxUPhZHVY6RxYYiE,2034
 clonebox/validator.py,sha256=LnQSZEdJXFGcJrTPxzS2cQUmAXucGeHDKwxrX632h_s,21188
 clonebox/templates/profiles/ml-dev.yaml,sha256=MT7Wu3xGBnYIsO5mzZ2GDI4AAEFGOroIx0eU3XjNARg,140
-clonebox-0.1.20.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-clonebox-0.1.20.dist-info/METADATA,sha256=qOJSrz8MfPrZe3zO0Q16AfcdD_ybXx-YuVAs0_sij2g,35353
-clonebox-0.1.20.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-clonebox-0.1.20.dist-info/entry_points.txt,sha256=FES95Vi3btfViLEEoHdb8nikNxTqzaooi9ehZw9ZfWI,47
-clonebox-0.1.20.dist-info/top_level.txt,sha256=LdMo2cvCrEcRGH2M8JgQNVsCoszLV0xug6kx1JnaRjo,9
-clonebox-0.1.20.dist-info/RECORD,,
+clonebox-0.1.21.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+clonebox-0.1.21.dist-info/METADATA,sha256=xvEQjhq84KYnf5oveMK8GRcfZXoBB54sZ9CrcRfTRpg,41534
+clonebox-0.1.21.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+clonebox-0.1.21.dist-info/entry_points.txt,sha256=FES95Vi3btfViLEEoHdb8nikNxTqzaooi9ehZw9ZfWI,47
+clonebox-0.1.21.dist-info/top_level.txt,sha256=LdMo2cvCrEcRGH2M8JgQNVsCoszLV0xug6kx1JnaRjo,9
+clonebox-0.1.21.dist-info/RECORD,,