milady 2.0.0a93__tar.gz

milady-2.0.0a93/.gitignore

@@ -0,0 +1,140 @@
+node_modules
+**/node_modules/
+.env
+dist
+storybook-static
+coverage
+tmp/
+apps/app/electron/build/
+apps/app/electrobun/build/
+.bun
+.DS_Store
+**/.DS_Store
+
+# Build artifacts
+*.bun-build
+**/*.bun-build
+*.tsbuildinfo
+apps/app/electron/tsc-out/
+
+# TypeScript declaration build outputs inside source dirs
+packages/*/src/**/*.d.ts
+packages/*/src/**/*.d.ts.map
+src/plugins/**/*.d.ts
+src/plugins/**/*.d.ts.map
+
+# Lock files (managed at repo root)
+package-lock.json
+bun.lockb
+pnpm-lock.yaml
+!deploy/cloud-agent-template/package-lock.json
+
+# Docker overrides
+docker-compose.extra.yml
+
+# UI test artifacts
+apps/ui/src/ui/__screenshots__/
+apps/ui/playwright-report/
+apps/ui/test-results/
+
+# Vendored repos (clone separately if needed)
+vendor/
+plugins/plugin-blooio/
+
+# Local untracked files
+.local/
+.vscode/
+.claude/settings.local.json
+.claude/skills/
+.git-workspace/
+IDENTITY.md
+USER.md
+*.tgz
+.eliza/
+.eliza.broken.*/
+.milady-repo-setup.lock
+.turbo/
+skills/*
+!skills/README.md
+!skills/integration-dod-map/
+skills/integration-dod-map/*
+!skills/integration-dod-map/SKILL.md
+apps/app/electron/.eliza
+apps/app/electron/skills/
+
+# Local workspace clones / scratch dirs
+milady-workspace/
+assets/
+
+# Temporary capture files
+temp_capture_*.jpg
+knip_output*.txt
+src/benchmark/mock-plugin.ts
+biome-report.json
+
+# Test/build log files
+*.log
+!docs/**/*.log
+
+# Local audit outputs
+report/
+
+# Agent learning docs & knowledge base
+knowledge/
+scripts/knowledge-loop.mjs
+test/contracts/
+apps/app/test-results/
+# WhatsApp session files (Baileys auth state)
+/auth/
+:memory:/
+benchmarks/
+/plugins/
+!docs/plugins/
+
+# Electrobun compiled native binaries (built locally, not committed)
+apps/app/electrobun/src/libMacWindowEffects.dylib
+# Electrobun built webview bridge preload (generated by `bun run build:preload`)
+apps/app/electrobun/src/preload.js
+# Electrobun build artifacts (created by `electrobun build`)
+apps/app/electrobun/artifacts/
+
+# Electron build directories
+apps/app/electron/app-build/
+apps/app/electron/milady-dist/
+dist-electron/
+
+# Build artifacts - installers and archives
+*.dmg
+*.AppImage
+*.exe
+*.msi
+*.deb
+*.rpm
+apps/app/electron/*.tar.gz
+
+# Test output directories
+test-output/
+
+# External plugin repos (not submodules)
+elizaos-plugins/
+e2e-screenshots/
+data/
+.avatar-clone-tmp
+
+# Debug PTY captures from plugin-agent-orchestrator (PARALLAX_DEBUG_CAPTURE=1)
+.parallax/
+.worktrees/
+
+# Generated raw avatar/animation assets from local setup hooks (non-source)
+apps/app/public/animations/**/*.fbx
+apps/app/public/animations/**/*.glb
+apps/app/public/animations/*.fbx
+apps/app/public/animations/*.glb
+apps/app/public/vrms/**/*.vrm
+apps/app/public/vrms/*.vrm
+apps/app/public/vrms/imported-avatars.json
+apps/app/public/vrms/backgrounds/*.png
+apps/app/public/vrms/previews/*.png
+apps/app/public/vrms/backgrounds/*.jpg
+apps/app/public/vrms/previews/*.jpg
+apps/app/public/vrms/*.jpg

milady-2.0.0a93/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: milady
+Version: 2.0.0a93
+Summary: Dynamic loader for Milady — personal AI assistant built on elizaOS
+Project-URL: Homepage, https://milady.ai
+Project-URL: Repository, https://github.com/milady-ai/milady
+Project-URL: Documentation, https://docs.milady.ai
+Project-URL: Issues, https://github.com/milady-ai/milady/issues
+Author-email: milady-ai <dev@milady.ai>
+License-Expression: MIT
+Keywords: agent,ai,assistant,cli,elizaos,llm,milady
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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 :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# milady
+
+**Dynamic Python loader for [Milady](https://github.com/milady-ai/milady)** — a personal AI assistant built on [elizaOS](https://github.com/elizaos).
+
+This package provides a `milady` command that automatically manages the Node.js-based Milady runtime. Install via pip, run like any CLI tool.
+
+## Install
+
+```bash
+pip install milady
+```
+
+Or with [pipx](https://pipx.pypa.io/) for isolated CLI install:
+
+```bash
+pipx install milady
+```
+
+## Quick Start
+
+```bash
+# Start your personal AI agent (installs runtime automatically on first run)
+milady start
+
+# Or just run it — interactive onboarding guides you through setup
+milady
+
+# Show all commands
+milady --help
+```
+
+## How It Works
+
+`milady` is a **dynamic loader** — a thin Python wrapper that:
+
+1. Checks for Node.js >= 22.12.0 on your system
+2. Ensures the `milady` npm package is installed globally
+3. Forwards all CLI commands to the Node.js runtime
+4. Installs the runtime automatically if not present
+
+This means you get the full Milady experience through pip/pipx, without needing to interact with npm directly.
+
+## Python API
+
+```python
+from milady import run, ensure_runtime, get_version
+
+# Ensure the runtime is installed and ready
+ensure_runtime()
+
+# Run a milady command programmatically
+exit_code = run(["start"])
+
+# Check the installed version
+version = get_version()
+print(f"Milady {version}")
+```
+
+## Requirements
+
+- **Python** >= 3.9
+- **Node.js** >= 22.12.0 (the loader will tell you how to install it if missing)
+
+## What is Milady?
+
+Milady is a personal AI assistant you run on your own devices. It provides:
+
+- Zero-config onboarding with interactive setup
+- Support for multiple AI providers (Anthropic, OpenAI, Google, Ollama, etc.)
+- Web dashboard at `http://localhost:18789`
+- Plugin system for extensibility
+- Web3 wallet integration (EVM + Solana)
+- Desktop apps for macOS, Windows, and Linux
+
+## Links
+
+- [Documentation](https://docs.milady.ai)
+- [GitHub](https://github.com/milady-ai/milady)
+- [elizaOS](https://github.com/elizaos)
+
+## License
+
+MIT

milady-2.0.0a93/README.md

@@ -0,0 +1,83 @@
+# milady
+
+**Dynamic Python loader for [Milady](https://github.com/milady-ai/milady)** — a personal AI assistant built on [elizaOS](https://github.com/elizaos).
+
+This package provides a `milady` command that automatically manages the Node.js-based Milady runtime. Install via pip, run like any CLI tool.
+
+## Install
+
+```bash
+pip install milady
+```
+
+Or with [pipx](https://pipx.pypa.io/) for isolated CLI install:
+
+```bash
+pipx install milady
+```
+
+## Quick Start
+
+```bash
+# Start your personal AI agent (installs runtime automatically on first run)
+milady start
+
+# Or just run it — interactive onboarding guides you through setup
+milady
+
+# Show all commands
+milady --help
+```
+
+## How It Works
+
+`milady` is a **dynamic loader** — a thin Python wrapper that:
+
+1. Checks for Node.js >= 22.12.0 on your system
+2. Ensures the `milady` npm package is installed globally
+3. Forwards all CLI commands to the Node.js runtime
+4. Installs the runtime automatically if not present
+
+This means you get the full Milady experience through pip/pipx, without needing to interact with npm directly.
+
+## Python API
+
+```python
+from milady import run, ensure_runtime, get_version
+
+# Ensure the runtime is installed and ready
+ensure_runtime()
+
+# Run a milady command programmatically
+exit_code = run(["start"])
+
+# Check the installed version
+version = get_version()
+print(f"Milady {version}")
+```
+
+## Requirements
+
+- **Python** >= 3.9
+- **Node.js** >= 22.12.0 (the loader will tell you how to install it if missing)
+
+## What is Milady?
+
+Milady is a personal AI assistant you run on your own devices. It provides:
+
+- Zero-config onboarding with interactive setup
+- Support for multiple AI providers (Anthropic, OpenAI, Google, Ollama, etc.)
+- Web dashboard at `http://localhost:18789`
+- Plugin system for extensibility
+- Web3 wallet integration (EVM + Solana)
+- Desktop apps for macOS, Windows, and Linux
+
+## Links
+
+- [Documentation](https://docs.milady.ai)
+- [GitHub](https://github.com/milady-ai/milady)
+- [elizaOS](https://github.com/elizaos)
+
+## License
+
+MIT

milady-2.0.0a93/milady/__init__.py

@@ -0,0 +1,35 @@
+"""
+milady — Dynamic loader for Milady, a personal AI assistant built on elizaOS.
+
+This package provides a Python entry point that dynamically loads and runs
+the Milady Node.js runtime. It handles Node.js detection, automatic
+installation of the milady npm package, and seamless CLI delegation.
+
+Usage (CLI):
+    $ milady start
+    $ milady setup
+    $ milady --help
+
+Usage (Python API):
+    from milady import run, ensure_runtime, get_version
+
+    # Ensure the runtime is ready
+    ensure_runtime()
+
+    # Run a command
+    exit_code = run(["start"])
+
+    # Get the installed version
+    version = get_version()
+"""
+
+__version__ = "2.0.0a93"
+__all__ = ["run", "ensure_runtime", "get_version", "MiladyError", "NodeNotFoundError"]
+
+from milady.loader import (
+    MiladyError,
+    NodeNotFoundError,
+    ensure_runtime,
+    get_version,
+    run,
+)

milady-2.0.0a93/milady/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running milady as a Python module: python -m milady"""
+
+from milady.cli import main
+
+main()

milady-2.0.0a93/milady/cli.py

@@ -0,0 +1,25 @@
+"""
+CLI entry point for the milady dynamic loader.
+
+Delegates all commands to the Milady Node.js runtime,
+installing it automatically if needed.
+"""
+
+from __future__ import annotations
+
+import sys
+
+from milady.loader import MiladyError, run
+
+
+def main() -> None:
+    """Main CLI entry point — forwards all args to the Node.js milady CLI."""
+    try:
+        args = sys.argv[1:]
+        exit_code = run(args)
+        sys.exit(exit_code)
+    except MiladyError as exc:
+        print(f"milady: {exc}", file=sys.stderr)
+        sys.exit(1)
+    except KeyboardInterrupt:
+        sys.exit(130)

milady-2.0.0a93/milady/loader.py

@@ -0,0 +1,275 @@
+"""
+Dynamic loader for the Milady Node.js runtime.
+
+Responsibilities:
+  1. Detect a suitable Node.js installation (>= 22.12.0)
+  2. Detect or install the milady npm package
+  3. Delegate CLI invocations to the Node.js process
+  4. Provide a Python API for programmatic use
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import re
+import shutil
+import subprocess
+import sys
+from typing import Optional, Sequence, Tuple
+
+# ── Constants ────────────────────────────────────────────────────────────────
+
+REQUIRED_NODE_VERSION: Tuple[int, int, int] = (22, 12, 0)
+NPM_PACKAGE = "milady"
+_VERSION_RE = re.compile(r"v?(\d+)\.(\d+)\.(\d+)")
+
+
+# ── Exceptions ───────────────────────────────────────────────────────────────
+
+
+class MiladyError(Exception):
+    """Base exception for milady loader errors."""
+
+
+class NodeNotFoundError(MiladyError):
+    """Raised when a suitable Node.js installation cannot be found."""
+
+
+class RuntimeInstallError(MiladyError):
+    """Raised when the milady npm package cannot be installed."""
+
+
+# ── Node.js Detection ────────────────────────────────────────────────────────
+
+
+def _parse_version(version_str: str) -> Optional[Tuple[int, int, int]]:
+    """Parse a semver string like 'v22.12.0' into a (major, minor, patch) tuple."""
+    match = _VERSION_RE.search(version_str)
+    if not match:
+        return None
+    return (int(match.group(1)), int(match.group(2)), int(match.group(3)))
+
+
+def _find_node() -> Optional[str]:
+    """Find a node binary on PATH."""
+    return shutil.which("node")
+
+
+def _get_node_version(node_bin: str) -> Optional[Tuple[int, int, int]]:
+    """Get the version of a Node.js binary."""
+    try:
+        result = subprocess.run(
+            [node_bin, "--version"],
+            capture_output=True,
+            text=True,
+            timeout=10,
+        )
+        if result.returncode == 0:
+            return _parse_version(result.stdout.strip())
+    except (subprocess.SubprocessError, OSError):
+        pass
+    return None
+
+
+def _check_node() -> str:
+    """
+    Find and validate a Node.js installation.
+
+    Returns the path to the node binary.
+    Raises NodeNotFoundError if no suitable version is found.
+    """
+    node_bin = _find_node()
+    if not node_bin:
+        req = ".".join(str(v) for v in REQUIRED_NODE_VERSION)
+        raise NodeNotFoundError(
+            f"Node.js not found. Milady requires Node.js >= {req}.\n"
+            "Install it from https://nodejs.org or via your package manager:\n"
+            "  macOS:   brew install node@22\n"
+            "  Linux:   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -\n"
+            "  Windows: winget install OpenJS.NodeJS.LTS"
+        )
+
+    version = _get_node_version(node_bin)
+    if version is None:
+        raise NodeNotFoundError(
+            f"Could not determine version of Node.js at {node_bin}"
+        )
+
+    if version < REQUIRED_NODE_VERSION:
+        current = ".".join(str(v) for v in version)
+        req = ".".join(str(v) for v in REQUIRED_NODE_VERSION)
+        raise NodeNotFoundError(
+            f"Node.js {current} found, but >= {req} is required.\n"
+            "Please upgrade Node.js: https://nodejs.org"
+        )
+
+    return node_bin
+
+
+# ── npm / npx Detection ─────────────────────────────────────────────────────
+
+
+def _find_npx() -> Optional[str]:
+    """Find npx on PATH."""
+    return shutil.which("npx")
+
+
+def _find_npm() -> Optional[str]:
+    """Find npm on PATH."""
+    return shutil.which("npm")
+
+
+def _is_milady_installed_globally() -> bool:
+    """Check if milady is installed as a global npm package."""
+    npm_bin = _find_npm()
+    if not npm_bin:
+        return False
+    try:
+        result = subprocess.run(
+            [npm_bin, "list", "-g", NPM_PACKAGE, "--json"],
+            capture_output=True,
+            text=True,
+            timeout=30,
+        )
+        if result.returncode == 0:
+            data = json.loads(result.stdout)
+            deps = data.get("dependencies", {})
+            return NPM_PACKAGE in deps
+    except (subprocess.SubprocessError, OSError, json.JSONDecodeError):
+        pass
+    return False
+
+
+def _find_milady_bin() -> Optional[str]:
+    """Find the milady CLI binary on PATH (from a global npm install)."""
+    return shutil.which("milady")
+
+
+def _install_milady_global() -> None:
+    """Install milady globally via npm."""
+    npm_bin = _find_npm()
+    if not npm_bin:
+        raise RuntimeInstallError(
+            "npm not found. Cannot install milady runtime.\n"
+            "Install Node.js (which includes npm) from https://nodejs.org"
+        )
+
+    print(
+        "milady: installing milady runtime (npm install -g miladyai)...",
+        file=sys.stderr,
+    )
+    try:
+        result = subprocess.run(
+            [npm_bin, "install", "-g", NPM_PACKAGE],
+            timeout=120,
+        )
+        if result.returncode != 0:
+            raise RuntimeInstallError(
+                f"Failed to install {NPM_PACKAGE} via npm (exit code {result.returncode}).\n"
+                "Try running manually: npm install -g miladyai"
+            )
+        print("milady: milady runtime installed successfully.", file=sys.stderr)
+    except subprocess.TimeoutExpired:
+        raise RuntimeInstallError(
+            f"Timed out installing {NPM_PACKAGE}. Check your network connection."
+        )
+
+
+# ── Public API ───────────────────────────────────────────────────────────────
+
+
+def ensure_runtime() -> str:
+    """
+    Ensure the Milady Node.js runtime is available.
+
+    Checks for Node.js, then checks for the milady npm package.
+    Installs milady globally if not found.
+
+    Returns:
+        Path to the milady CLI binary or npx fallback.
+
+    Raises:
+        NodeNotFoundError: If Node.js is not installed or too old.
+        RuntimeInstallError: If milady cannot be installed.
+    """
+    _check_node()
+
+    milady_bin = _find_milady_bin()
+    if milady_bin:
+        return milady_bin
+
+    # Not found on PATH — try installing globally
+    _install_milady_global()
+
+    milady_bin = _find_milady_bin()
+    if not milady_bin:
+        # Fall back to npx
+        npx_bin = _find_npx()
+        if npx_bin:
+            return npx_bin
+        raise RuntimeInstallError(
+            "milady was installed but the binary was not found on PATH.\n"
+            "Try: export PATH=\"$(npm config get prefix)/bin:$PATH\""
+        )
+
+    return milady_bin
+
+
+def run(args: Optional[Sequence[str]] = None) -> int:
+    """
+    Run a milady CLI command.
+
+    Args:
+        args: CLI arguments to pass to milady (e.g. ["start", "--verbose"]).
+              If None, defaults to empty list.
+
+    Returns:
+        The exit code from the milady process.
+
+    Raises:
+        MiladyError: If the runtime cannot be found or started.
+    """
+    if args is None:
+        args = []
+
+    bin_path = ensure_runtime()
+
+    # If we got npx back (fallback), run via npx
+    if os.path.basename(bin_path) == "npx":
+        cmd = [bin_path, NPM_PACKAGE, *list(args)]
+    else:
+        cmd = [bin_path, *list(args)]
+
+    try:
+        result = subprocess.run(cmd)
+        return result.returncode
+    except FileNotFoundError:
+        raise MiladyError(f"Could not execute: {bin_path}")
+    except OSError as exc:
+        raise MiladyError(f"Failed to run milady: {exc}")
+
+
+def get_version() -> Optional[str]:
+    """
+    Get the installed milady version.
+
+    Returns:
+        Version string (e.g. "2.0.0-alpha.7") or None if not installed.
+    """
+    milady_bin = _find_milady_bin()
+    if not milady_bin:
+        return None
+
+    try:
+        result = subprocess.run(
+            [milady_bin, "--version"],
+            capture_output=True,
+            text=True,
+            timeout=10,
+        )
+        if result.returncode == 0:
+            return result.stdout.strip().split("\n")[-1]
+    except (subprocess.SubprocessError, OSError):
+        pass
+    return None

milady-2.0.0a93/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "milady"
+version = "2.0.0a93"
+description = "Dynamic loader for Milady — personal AI assistant built on elizaOS"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "milady-ai", email = "dev@milady.ai" },
+]
+keywords = [
+    "ai",
+    "assistant",
+    "agent",
+    "elizaos",
+    "milady",
+    "milady",
+    "llm",
+    "cli",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://milady.ai"
+Repository = "https://github.com/milady-ai/milady"
+Documentation = "https://docs.milady.ai"
+Issues = "https://github.com/milady-ai/milady/issues"
+
+[project.scripts]
+milady = "milady.cli:main"
+
+
+[tool.hatch.build.targets.wheel]
+packages = ["milady"]