alpiecode 2.0.5__tar.gz → 2.0.7__tar.gz

{alpiecode-2.0.5 → alpiecode-2.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpiecode
-Version: 2.0.5
+Version: 2.0.7
 Summary: AlpieCode — Autonomous AI Coding Agent CLI powered by local 169Pi GGUF VLM
 Requires-Python: >=3.9
 Requires-Dist: huggingface_hub>=0.20.0

{alpiecode-2.0.5 → alpiecode-2.0.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "alpiecode"
-version = "2.0.5"
+version = "2.0.7"
 description = "AlpieCode — Autonomous AI Coding Agent CLI powered by local 169Pi GGUF VLM"
 requires-python = ">=3.9"
 dependencies = [

alpiecode-2.0.7/src/alpiecode/__init__.py

@@ -0,0 +1,15 @@
+"""
+AlpieCode package alias pointing to codeagent core engine.
+"""
+
+from codeagent import *
+from codeagent import (
+    run,
+    plan,
+    explain,
+    chat,
+    doctor,
+    load_ipython_extension,
+    unload_ipython_extension,
+    __version__,
+)

{alpiecode-2.0.5 → alpiecode-2.0.7}/src/alpiecode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpiecode
-Version: 2.0.5
+Version: 2.0.7
 Summary: AlpieCode — Autonomous AI Coding Agent CLI powered by local 169Pi GGUF VLM
 Requires-Python: >=3.9
 Requires-Dist: huggingface_hub>=0.20.0

{alpiecode-2.0.5 → alpiecode-2.0.7}/src/alpiecode.egg-info/SOURCES.txt

@@ -1,5 +1,6 @@
 README.md
 pyproject.toml
+src/alpiecode/__init__.py
 src/alpiecode.egg-info/PKG-INFO
 src/alpiecode.egg-info/SOURCES.txt
 src/alpiecode.egg-info/dependency_links.txt
@@ -18,6 +19,7 @@ src/codeagent/doctor.py
 src/codeagent/executor.py
 src/codeagent/github.py
 src/codeagent/guardian.py
+src/codeagent/ipython_ext.py
 src/codeagent/local_model.py
 src/codeagent/media.py
 src/codeagent/memory.py

{alpiecode-2.0.5 → alpiecode-2.0.7}/src/alpiecode.egg-info/top_level.txt

@@ -1 +1,2 @@
+alpiecode
 codeagent

alpiecode-2.0.7/src/codeagent/__init__.py

@@ -0,0 +1,106 @@
+"""
+AlpieCode — Autonomous AI Coding Agent powered by local 169Pi GGUF VLM & Online API.
+
+Supports:
+- CLI usage (`alpiecode run`, `alpiecode serve`, `alpiecode doctor`)
+- Jupyter Notebooks & Google Colab (`%load_ext alpiecode`, `%alpie <task>`)
+- Python SDK API (`import alpiecode; alpiecode.run("...")`)
+- VS Code Extension
+"""
+
+from pathlib import Path
+from typing import Optional, Any, Dict
+
+__version__ = "2.0.4"
+
+
+def run(task: str, workdir: str = ".", reasoning_level: str = "medium", **kwargs):
+    """Run an autonomous coding task programmatically."""
+    from .config import load_config
+    from .agent import run_agent
+    cfg = load_config()
+    if reasoning_level == "low":
+        cfg.enable_thinking = False
+        cfg.temperature = 0.0
+    elif reasoning_level == "medium":
+        cfg.enable_thinking = True
+        cfg.temperature = 0.1
+    elif reasoning_level == "high":
+        cfg.enable_thinking = True
+        cfg.temperature = 0.2
+    return run_agent(task, Path(workdir).resolve(), cfg, verbose=kwargs.get("verbose", True))
+
+
+def plan(task: str, workdir: str = ".", **kwargs):
+    """Generate an implementation plan without making edits."""
+    from .config import load_config
+    from .agent import run_agent
+    cfg = load_config()
+    plan_task = (
+        f"PLANNING ONLY — Do NOT make any file edits. "
+        f"Analyze the codebase and create a detailed implementation plan for the following task. "
+        f"Use list_files, read_file, and file_search to understand the project. "
+        f"Then use update_plan to write a structured plan with deliverables and checks. "
+        f"Finish with DONE: when the plan is complete.\n\n"
+        f"Task: {task}"
+    )
+    return run_agent(plan_task, Path(workdir).resolve(), cfg, verbose=kwargs.get("verbose", True))
+
+
+def explain(target: str, workdir: str = ".", **kwargs):
+    """Explain a file, function, or concept."""
+    from .config import load_config
+    from .agent import run_agent
+    cfg = load_config()
+    target_path = Path(workdir) / target if not Path(target).is_absolute() else Path(target)
+    if target_path.exists() and target_path.is_file():
+        content = target_path.read_text(encoding="utf-8", errors="replace")
+        explain_task = (
+            f"EXPLANATION ONLY — Do NOT make any file edits.\n\n"
+            f"Please explain the file `{target}` in detail:\n"
+            f"1. Overview of its purpose and role\n"
+            f"2. Key functions, classes, and internal logic\n"
+            f"3. Dependencies and how it connects to the project\n"
+            f"4. Step-by-step walkthrough of how it executes\n\n"
+            f"File content ({target}):\n```\n{content[:16000]}\n```"
+        )
+    else:
+        explain_task = f"EXPLANATION ONLY — Do NOT make any file edits.\n\nExplain topic: {target}"
+    return run_agent(explain_task, Path(workdir).resolve(), cfg, verbose=kwargs.get("verbose", True))
+
+
+def chat(workdir: str = ".", **kwargs):
+    """Start an interactive CLI chat session."""
+    from .config import load_config
+    from .agent import run_chat
+    cfg = load_config()
+    return run_chat(Path(workdir).resolve(), cfg, verbose=kwargs.get("verbose", True))
+
+
+def doctor() -> int:
+    """Run system health diagnostics."""
+    from .doctor import run_doctor
+    return run_doctor()
+
+
+# Re-export IPython extension loaders so `%load_ext alpiecode` works seamlessly
+def load_ipython_extension(ipython):
+    from .ipython_ext import load_ipython_extension as _load
+    _load(ipython)
+
+
+def unload_ipython_extension(ipython):
+    from .ipython_ext import unload_ipython_extension as _unload
+    _unload(ipython)
+
+
+__all__ = [
+    "run",
+    "plan",
+    "explain",
+    "chat",
+    "doctor",
+    "load_ipython_extension",
+    "unload_ipython_extension",
+    "__version__",
+]

alpiecode-2.0.7/src/codeagent/ipython_ext.py

@@ -0,0 +1,140 @@
+"""
+IPython & Jupyter / Google Colab extension for AlpieCode.
+
+Enables seamless usage of AlpieCode inside Jupyter Notebooks, JupyterLab,
+and Google Colab via cell/line magic commands and rich interactive displays:
+
+    %load_ext alpiecode
+    %alpie write a quick pandas script to inspect data.csv
+    %%alpie
+    Create a complete PyTorch model training pipeline.
+"""
+
+import sys
+from pathlib import Path
+from typing import Optional
+
+from .config import load_config
+from .agent import run_agent
+
+
+def _is_notebook() -> bool:
+    """Check if code is running inside a Jupyter notebook or Google Colab."""
+    try:
+        from IPython import get_ipython
+        shell = get_ipython()
+        if shell is None:
+            return False
+        shell_name = shell.__class__.__name__
+        if "ZMQInteractiveShell" in shell_name or "Shell" in shell_name:
+            return True
+        return False
+    except Exception:
+        return False
+
+
+def _display_html(html_str: str):
+    """Render rich HTML in Jupyter or Google Colab."""
+    try:
+        from IPython.display import HTML, display
+        display(HTML(html_str))
+    except Exception:
+        print(html_str)
+
+
+def alpie_magic(line: str, cell: Optional[str] = None):
+    """
+    %alpie <task>        (line magic)
+    %%alpie              (cell magic)
+    <multiline task>
+    """
+    task = (cell if cell is not None and cell.strip() else line).strip()
+    if not task:
+        print("Usage: %alpie <task>  OR  %%alpie\\n<multiline task>")
+        return
+
+    cfg = load_config()
+    workdir = Path(".").resolve()
+
+    if _is_notebook():
+        _display_html(
+            f'<div style="border-left: 3px solid #60a5fa; padding: 6px 12px; background: rgba(96,165,250,0.08); border-radius: 4px; font-family: sans-serif; margin-bottom: 8px;">'
+            f'<strong style="color: #60a5fa;">⚡ AlpieCode Agent:</strong> {task[:120]}'
+            f'</div>'
+        )
+
+    run_agent(task, workdir, cfg, verbose=True)
+
+
+def alpie_plan_magic(line: str, cell: Optional[str] = None):
+    """%alpie_plan <task> — Generate a structured implementation plan without making edits."""
+    task = (cell if cell is not None and cell.strip() else line).strip()
+    if not task:
+        print("Usage: %alpie_plan <task>")
+        return
+
+    plan_task = (
+        f"PLANNING ONLY — Do NOT make any file edits. "
+        f"Analyze the codebase and create a detailed implementation plan for the following task. "
+        f"Use list_files, read_file, and file_search to understand the project. "
+        f"Then use update_plan to write a structured plan with deliverables and checks. "
+        f"Finish with DONE: when the plan is complete.\n\n"
+        f"Task: {task}"
+    )
+
+    cfg = load_config()
+    workdir = Path(".").resolve()
+    run_agent(plan_task, workdir, cfg, verbose=True)
+
+
+def alpie_explain_magic(line: str):
+    """%alpie_explain <file_path_or_concept> — Explain code or architecture."""
+    target = line.strip()
+    if not target:
+        print("Usage: %alpie_explain <file_path_or_concept>")
+        return
+
+    cfg = load_config()
+    workdir = Path(".").resolve()
+    target_path = workdir / target if not Path(target).is_absolute() else Path(target)
+
+    if target_path.exists() and target_path.is_file():
+        content = target_path.read_text(encoding="utf-8", errors="replace")
+        explain_task = (
+            f"EXPLANATION ONLY — Do NOT make any file edits.\n\n"
+            f"Please explain the file `{target}` in detail:\n"
+            f"1. Overview of its purpose and role\n"
+            f"2. Key functions, classes, and internal logic\n"
+            f"3. Dependencies and how it connects to the project\n"
+            f"4. Step-by-step walkthrough of how it executes\n\n"
+            f"File content ({target}):\n```\n{content[:16000]}\n```"
+        )
+    else:
+        explain_task = (
+            f"EXPLANATION ONLY — Do NOT make any file edits.\n\n"
+            f"Explain the following codebase concept or architecture in detail:\n"
+            f"Topic: {target}\n\n"
+            f"Use read_file or file_search if needed to understand codebase context."
+        )
+
+    run_agent(explain_task, workdir, cfg, verbose=True)
+
+
+def alpie_doctor_magic(line: str = ""):
+    """%alpie_doctor — Run system health diagnostic checks."""
+    from .doctor import run_doctor
+    run_doctor()
+
+
+def load_ipython_extension(ipython):
+    """Called by IPython when user runs `%load_ext alpiecode`."""
+    ipython.register_magic_function(alpie_magic, magic_kind="line_cell", magic_name="alpie")
+    ipython.register_magic_function(alpie_plan_magic, magic_kind="line_cell", magic_name="alpie_plan")
+    ipython.register_magic_function(alpie_explain_magic, magic_kind="line", magic_name="alpie_explain")
+    ipython.register_magic_function(alpie_doctor_magic, magic_kind="line", magic_name="alpie_doctor")
+    print("✨ AlpieCode IPython/Jupyter Extension Loaded! Try: %alpie <task> or %%alpie")
+
+
+def unload_ipython_extension(ipython):
+    """Called when user runs `%unload_ext alpiecode`."""
+    pass

alpiecode-2.0.5/src/codeagent/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.1.0"