ralphx 0.2.2__tar.gz → 0.3.5__tar.gz

{ralphx-0.2.2 → ralphx-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ralphx
-Version: 0.2.2
+Version: 0.3.5
 Summary: Autonomous AI loop orchestration for Claude Code - define workflows in YAML, run autonomously, monitor in real-time
 Project-URL: Homepage, https://github.com/jackneil/ralphx
 Project-URL: Repository, https://github.com/jackneil/ralphx
@@ -34,8 +34,6 @@ Requires-Dist: httpx>=0.24; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
 Requires-Dist: pytest>=7.0; extra == 'dev'
 Requires-Dist: ruff>=0.1; extra == 'dev'
-Provides-Extra: mcp
-Requires-Dist: mcp>=0.1; extra == 'mcp'
 Description-Content-Type: text/markdown
 
 # RalphX
@@ -106,7 +104,7 @@ for product development. I'm not technical so please handle everything:
 1. Check if I have conda/miniconda installed. If not, install miniconda for my OS.
 2. Create a Python 3.11 environment called "ralphx" and activate it
 3. Install RalphX from PyPI: pip install ralphx
-4. Add RalphX as an MCP server so you can control it: claude mcp add ralphx -- ralphx mcp
+4. Add RalphX as an MCP server using the full path to the ralphx binary in the conda env (use the right command for my OS to find it)
 5. Start the RalphX dashboard: ralphx serve
 6. Ask me if I want a desktop shortcut to launch the dashboard. If yes, create
    a shortcut for my OS that uses the full path to the Python executable in the
@@ -130,10 +128,26 @@ Open `http://localhost:16768` to monitor progress.
 
 ---
 
-**Already technical?** Here's the one-liner:
+**Already technical?** Here's the quick setup:
 
 ```bash
-pip install ralphx && claude mcp add ralphx -- ralphx mcp
+# Create and activate a Python 3.11+ environment:
+conda create -n ralphx python=3.11 -y && conda activate ralphx
+
+# Install RalphX:
+pip install ralphx
+
+# Add MCP server with full path to ralphx binary:
+
+# Linux/Mac:
+claude mcp add ralphx -e PYTHONDONTWRITEBYTECODE=1 -- "$(which ralphx)" mcp
+
+# Mac (zsh) - if "which ralphx" fails, first run: conda init zsh && source ~/.zshrc
+
+# Windows - first find your path, then use it:
+#   CMD:        where.exe ralphx
+#   PowerShell: (Get-Command ralphx).Source
+claude mcp add ralphx -e PYTHONDONTWRITEBYTECODE=1 -- C:\Users\YOU\miniconda3\envs\ralphx\Scripts\ralphx.exe mcp
 ```
 
 ---
@@ -226,16 +240,23 @@ Ask Claude: *"Set up a new-product workflow starting from my idea for a task man
 For those who prefer to do it themselves:
 
 ```bash
-# If you don't have conda, install miniconda first:
-# https://docs.conda.io/en/latest/miniconda.html
-
-# Create environment and install
+# Create a virtual environment (use conda, venv, or your preferred tool)
+# Example with conda:
 conda create -n ralphx python=3.11 -y
 conda activate ralphx
+
+# Or with venv:
+# python3 -m venv ~/.venvs/ralphx && source ~/.venvs/ralphx/bin/activate
+
+# Install RalphX
 pip install ralphx
 
-# Set up MCP so Claude can control RalphX
-claude mcp add ralphx -- ralphx mcp
+# Set up MCP so Claude can control RalphX (uses full path so it works outside the env)
+# Linux/Mac:
+claude mcp add ralphx -e PYTHONDONTWRITEBYTECODE=1 -- "$(which ralphx)" mcp
+# Mac (zsh): if "which" fails, run: conda init zsh && source ~/.zshrc
+# Windows: find path with "where.exe ralphx" (CMD) or "(Get-Command ralphx).Source" (PowerShell)
+#          then: claude mcp add ralphx -e PYTHONDONTWRITEBYTECODE=1 -- C:\Users\YOU\...\ralphx.exe mcp
 
 # Start the dashboard
 ralphx serve
@@ -296,6 +317,7 @@ Claude gets full access to RalphX:
 - [SDLC Workflows](design/SDLC_WORKFLOWS.md) - All workflow templates explained
 - [Design Overview](design/DESIGN.md) - Architecture deep dive
 - [Loop Schema](design/LOOP_SCHEMA.md) - Configuration reference
+- [Backup & Import Guide](docs/BACKUP_AND_IMPORT.md) - Export workflows, import items
 
 ---
 

{ralphx-0.2.2 → ralphx-0.3.5}/README.md

@@ -66,7 +66,7 @@ for product development. I'm not technical so please handle everything:
 1. Check if I have conda/miniconda installed. If not, install miniconda for my OS.
 2. Create a Python 3.11 environment called "ralphx" and activate it
 3. Install RalphX from PyPI: pip install ralphx
-4. Add RalphX as an MCP server so you can control it: claude mcp add ralphx -- ralphx mcp
+4. Add RalphX as an MCP server using the full path to the ralphx binary in the conda env (use the right command for my OS to find it)
 5. Start the RalphX dashboard: ralphx serve
 6. Ask me if I want a desktop shortcut to launch the dashboard. If yes, create
    a shortcut for my OS that uses the full path to the Python executable in the
@@ -90,10 +90,26 @@ Open `http://localhost:16768` to monitor progress.
 
 ---
 
-**Already technical?** Here's the one-liner:
+**Already technical?** Here's the quick setup:
 
 ```bash
-pip install ralphx && claude mcp add ralphx -- ralphx mcp
+# Create and activate a Python 3.11+ environment:
+conda create -n ralphx python=3.11 -y && conda activate ralphx
+
+# Install RalphX:
+pip install ralphx
+
+# Add MCP server with full path to ralphx binary:
+
+# Linux/Mac:
+claude mcp add ralphx -e PYTHONDONTWRITEBYTECODE=1 -- "$(which ralphx)" mcp
+
+# Mac (zsh) - if "which ralphx" fails, first run: conda init zsh && source ~/.zshrc
+
+# Windows - first find your path, then use it:
+#   CMD:        where.exe ralphx
+#   PowerShell: (Get-Command ralphx).Source
+claude mcp add ralphx -e PYTHONDONTWRITEBYTECODE=1 -- C:\Users\YOU\miniconda3\envs\ralphx\Scripts\ralphx.exe mcp
 ```
 
 ---
@@ -186,16 +202,23 @@ Ask Claude: *"Set up a new-product workflow starting from my idea for a task man
 For those who prefer to do it themselves:
 
 ```bash
-# If you don't have conda, install miniconda first:
-# https://docs.conda.io/en/latest/miniconda.html
-
-# Create environment and install
+# Create a virtual environment (use conda, venv, or your preferred tool)
+# Example with conda:
 conda create -n ralphx python=3.11 -y
 conda activate ralphx
+
+# Or with venv:
+# python3 -m venv ~/.venvs/ralphx && source ~/.venvs/ralphx/bin/activate
+
+# Install RalphX
 pip install ralphx
 
-# Set up MCP so Claude can control RalphX
-claude mcp add ralphx -- ralphx mcp
+# Set up MCP so Claude can control RalphX (uses full path so it works outside the env)
+# Linux/Mac:
+claude mcp add ralphx -e PYTHONDONTWRITEBYTECODE=1 -- "$(which ralphx)" mcp
+# Mac (zsh): if "which" fails, run: conda init zsh && source ~/.zshrc
+# Windows: find path with "where.exe ralphx" (CMD) or "(Get-Command ralphx).Source" (PowerShell)
+#          then: claude mcp add ralphx -e PYTHONDONTWRITEBYTECODE=1 -- C:\Users\YOU\...\ralphx.exe mcp
 
 # Start the dashboard
 ralphx serve
@@ -256,6 +279,7 @@ Claude gets full access to RalphX:
 - [SDLC Workflows](design/SDLC_WORKFLOWS.md) - All workflow templates explained
 - [Design Overview](design/DESIGN.md) - Architecture deep dive
 - [Loop Schema](design/LOOP_SCHEMA.md) - Configuration reference
+- [Backup & Import Guide](docs/BACKUP_AND_IMPORT.md) - Export workflows, import items
 
 ---
 

{ralphx-0.2.2 → ralphx-0.3.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ralphx"
-version = "0.2.2"
+version = "0.3.5"
 description = "Autonomous AI loop orchestration for Claude Code - define workflows in YAML, run autonomously, monitor in real-time"
 readme = "README.md"
 license = "MIT"
@@ -53,9 +53,6 @@ dev = [
     "httpx>=0.24",
     "ruff>=0.1",
 ]
-mcp = [
-    "mcp>=0.1",
-]
 
 [project.scripts]
 ralphx = "ralphx.cli:main"
@@ -67,8 +64,18 @@ Documentation = "https://github.com/jackneil/ralphx#readme"
 
 [tool.hatch.build.targets.wheel]
 packages = ["ralphx"]
-# Include static files (frontend build) in the wheel
-artifacts = ["ralphx/static/**"]
+# Exclude static and examples - they're added explicitly via force-include
+# to avoid duplicate entries when these dirs exist during CI build
+exclude = [
+    "ralphx/static",
+    "ralphx/static/**",
+    "ralphx/examples",
+    "ralphx/examples/**",
+]
+
+[tool.hatch.build.targets.wheel.force-include]
+"ralphx/static" = "ralphx/static"
+"ralphx/examples" = "ralphx/examples"
 
 [tool.hatch.build.targets.sdist]
 include = [
@@ -77,6 +84,10 @@ include = [
     "/LICENSE",
 ]
 
+[tool.hatch.build.targets.sdist.force-include]
+"ralphx/static" = "ralphx/static"
+"ralphx/examples" = "ralphx/examples"
+
 [tool.ruff]
 line-length = 100
 target-version = "py310"

{ralphx-0.2.2 → ralphx-0.3.5}/ralphx/__init__.py

@@ -1,6 +1,6 @@
 """RalphX - Generic agent loop orchestration system."""
 
-__version__ = "0.1.0"
+__version__ = "0.3.5"
 __author__ = "Jack"
 
 # Package metadata

{ralphx-0.2.2 → ralphx-0.3.5}/ralphx/api/main.py

@@ -27,7 +27,7 @@ from fastapi.responses import FileResponse, JSONResponse
 from fastapi.staticfiles import StaticFiles
 
 from ralphx import __version__
-from ralphx.api.routes import auth, config, files, filesystem, imports, items, logs, loops, planning, projects, resources, runs, stream, templates, workflows
+from ralphx.api.routes import auth, config, export_import, files, filesystem, imports, items, logs, loops, planning, projects, resources, runs, stream, templates, workflows
 from ralphx.core.auth import restore_orphaned_backup
 from ralphx.core.workspace import ensure_workspace
 
@@ -123,10 +123,17 @@ async def _stale_run_cleanup_loop():
 async def lifespan(app: FastAPI):
     """Application lifespan events."""
     from ralphx.core.logger import system_log
+    from ralphx.core.sample_project import ensure_sample_project_created
 
     # Startup
     ensure_workspace()
 
+    # Create sample project on first run
+    try:
+        ensure_sample_project_created()
+    except Exception as e:
+        logger.warning(f"Sample project creation failed: {e}")
+
     # Restore any orphaned credential backups from previous crashes
     # This ensures user's main credentials are ALWAYS restored
     restore_orphaned_backup()
@@ -278,6 +285,7 @@ app.include_router(logs.router, prefix="/api", tags=["logs"])
 app.include_router(config.router, prefix="/api/projects", tags=["config"])
 app.include_router(workflows.router, prefix="/api/projects/{slug}", tags=["workflows"])
 app.include_router(planning.router, prefix="/api/projects/{slug}", tags=["planning"])
+app.include_router(export_import.router, prefix="/api/projects/{slug}", tags=["export-import"])
 
 
 # Root endpoint