nanoPyCodeAgent 0.1.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

nanopycodeagent/__init__.py

@@ -1,2 +1,5 @@
+from nanopycodeagent.agent import run
+
+
 def main() -> None:
-    print("hello nanoPyCodeAgent")
+    run()

nanopycodeagent/agent.py

@@ -0,0 +1,181 @@
+"""A minimal agent loop built on the Anthropic Python SDK.
+
+Run the program, type a message, and Agent replies. The full conversation is
+kept in memory so each turn has context. Type ``/exit`` to quit.
+"""
+
+import json
+import os
+from pathlib import Path
+
+import anthropic
+import httpx
+from anthropic.types import MessageParam
+
+# The model used when ANTHROPIC_MODEL is set in neither the environment nor the
+# config file.
+DEFAULT_MODEL = "claude-sonnet-4-6"
+MAX_TOKENS = 8192
+SYSTEM_PROMPT = "You are nanoPyCodeAgent, a concise and helpful coding assistant."
+
+
+# User-level config file. Its ``env`` mapping supplies ANTHROPIC_* values for
+# keys that are not already set in the environment (environment variables win).
+def _default_settings_path() -> Path | None:
+    """Resolve the user-level config path, or ``None`` if home is unknown.
+
+    ``Path.home()`` raises ``RuntimeError`` when the home directory cannot be
+    determined (e.g. ``$HOME`` unset and no passwd entry, common in minimal
+    containers). Guarding it here keeps ``import nanopycodeagent`` — which runs
+    eagerly behind the console script — from crashing at import; a ``None`` path
+    simply means "no user config file".
+    """
+    try:
+        return Path.home() / ".nanoPyCodeAgent" / "settings.json"
+    except RuntimeError:
+        return None
+
+
+SETTINGS_PATH = _default_settings_path()
+
+
+def load_settings_env(path: Path | None = None) -> None:
+    """Apply the ``env`` mapping from the config file into ``os.environ``.
+
+    ``path`` defaults to the module-level ``SETTINGS_PATH`` (resolved at call
+    time, so it stays overridable). Only ``ANTHROPIC_*`` keys that are not
+    already present are set, so environment variables take precedence over the
+    config file and unrelated variables are never injected. Behaviour by case:
+
+    - Missing file, or a home directory that cannot be resolved: silently
+      ignored (running without a config file is normal).
+    - Unreadable / non-UTF-8 file, malformed JSON, non-object top level, or a
+      non-object ``env``: a warning is printed and the file is otherwise
+      ignored — a bad config never blocks startup.
+    - Empty, whitespace-only, or non-string values, and values the OS rejects
+      (e.g. an embedded NUL): skipped (the documented example ships these keys
+      as empty-string placeholders).
+    """
+    if path is None:
+        path = SETTINGS_PATH
+    if path is None:
+        return  # home dir unresolvable → behave as if no config file exists
+    try:
+        raw = path.read_text(encoding="utf-8")
+    except FileNotFoundError:
+        return
+    except (OSError, UnicodeDecodeError) as exc:
+        print(f"Warning: could not read config file {path}: {exc}")
+        return
+
+    try:
+        data = json.loads(raw)
+    except json.JSONDecodeError as exc:
+        print(f"Warning: ignoring malformed config file {path}: {exc}")
+        return
+
+    if not isinstance(data, dict):
+        print(f"Warning: ignoring config file {path}: top level must be an object.")
+        return
+
+    env = data.get("env", {})
+    if not isinstance(env, dict):
+        print(f"Warning: ignoring 'env' in config file {path}: it must be an object.")
+        return
+
+    for key, value in env.items():
+        # Only honor ANTHROPIC_* keys (the config's documented purpose) so a
+        # shared settings.json cannot silently inject unrelated variables such
+        # as HTTPS_PROXY into the process environment.
+        if not key.startswith("ANTHROPIC_"):
+            continue
+        if not (isinstance(value, str) and value.strip()):
+            continue
+        try:
+            os.environ.setdefault(key, value.strip())
+        except ValueError as exc:
+            # e.g. an embedded NUL in the value or '=' in the key name.
+            print(f"Warning: ignoring invalid config entry {key!r}: {exc}")
+
+
+def run() -> None:
+    """Start the read → ask → answer loop until the user types ``/exit``."""
+    # Fill any unset ANTHROPIC_* keys from the config file (environment variables
+    # take precedence), then let the SDK read credentials from os.environ.
+    load_settings_env()
+    client = anthropic.Anthropic()
+    if client.api_key is None and client.auth_token is None:
+        print(
+            "No API credentials found. Set the ANTHROPIC_API_KEY environment variable."
+        )
+        print(
+            "If you use a third-party / proxy service, also set ANTHROPIC_BASE_URL "
+            "to point at its endpoint."
+        )
+        return
+
+    # Resolve the model after load_settings_env() so a config-file ANTHROPIC_MODEL
+    # is honored. An empty or whitespace-only value falls back to the default.
+    configured_model = os.environ.get("ANTHROPIC_MODEL", "").strip()
+    model = configured_model or DEFAULT_MODEL
+
+    messages: list[MessageParam] = []
+    if configured_model:
+        print(f"nanoPyCodeAgent — using model {model} (from ANTHROPIC_MODEL).")
+    else:
+        print(
+            f"nanoPyCodeAgent — using default model {model} "
+            "(set ANTHROPIC_MODEL to override)."
+        )
+    print("Type a message to chat, or /exit to quit.")
+
+    while True:
+        try:
+            user_input = input("\nYou> ").strip()
+        except (EOFError, KeyboardInterrupt):
+            print()
+            break
+
+        if not user_input:
+            continue
+        if user_input == "/exit":
+            break
+
+        messages.append({"role": "user", "content": user_input})
+
+        try:
+            print("\nAgent> ", end="", flush=True)
+            # Stream the reply so text shows up as it is generated, then grab
+            # the accumulated message for the conversation history.
+            with client.messages.stream(
+                model=model,
+                max_tokens=MAX_TOKENS,
+                system=SYSTEM_PROMPT,
+                messages=messages,
+            ) as stream:
+                for text in stream.text_stream:
+                    print(text, end="", flush=True)
+                message = stream.get_final_message()
+            print()
+        except KeyboardInterrupt:
+            # Ctrl-C while streaming the reply cancels cleanly, mirroring the
+            # graceful quit offered at the input prompt.
+            print()
+            break
+        except anthropic.AuthenticationError:
+            print(
+                "\nAuthentication failed. Check that ANTHROPIC_API_KEY is set correctly."
+            )
+            break
+        except (anthropic.APIError, httpx.HTTPError) as exc:
+            # httpx.HTTPError: the SDK wraps transport errors only around the
+            # initial send, so a network failure mid-stream surfaces as a raw
+            # httpx error during iteration rather than an anthropic.APIError.
+            print(f"\nRequest failed: {exc}")
+            messages.pop()  # drop the unanswered user turn so history stays valid
+            continue
+
+        # Append the full content blocks so the next turn carries complete context.
+        messages.append({"role": "assistant", "content": message.content})
+
+    print("Bye!")

{nanopycodeagent-0.1.0.dist-info → nanopycodeagent-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nanoPyCodeAgent
-Version: 0.1.0
+Version: 0.3.0
 Summary: A nano code agent built from scratch in pure Python.
 Project-URL: Homepage, https://github.com/minixalpha/nanoPyCodeAgent
 Project-URL: Repository, https://github.com/minixalpha/nanoPyCodeAgent
@@ -13,6 +13,7 @@ Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.13
+Requires-Dist: anthropic>=0.112.0
 Description-Content-Type: text/markdown
 
 # nanoPyCodeAgent
@@ -60,6 +61,32 @@ uvx --from "git+https://github.com/minixalpha/nanoPyCodeAgent@main" nanoPyCodeAg
 uvx --from "git+https://github.com/minixalpha/nanoPyCodeAgent@v0.1.0" nanoPyCodeAgent
 ```
 
+### Configuration
+
+Credentials and the model come from two sources: **environment variables** and
+an optional user-level config file at `~/.nanoPyCodeAgent/settings.json`.
+Environment variables take precedence — the config file only fills in keys you
+have not set in the environment.
+
+The config file mirrors [Claude Code's settings](https://code.claude.com/docs/en/settings):
+put the values under an `env` object. Empty or whitespace-only values are ignored.
+
+```json
+{
+  "env": {
+    "ANTHROPIC_API_KEY": "",
+    "ANTHROPIC_BASE_URL": "",
+    "ANTHROPIC_MODEL": ""
+  }
+}
+```
+
+| Variable | Required | Default | Description |
+| --- | --- | --- | --- |
+| `ANTHROPIC_API_KEY` | Yes | — | Your Anthropic API key, or the key for a third-party / proxy service. |
+| `ANTHROPIC_BASE_URL` | No | `https://api.anthropic.com` | Point the SDK at a non-official / proxy endpoint. Leave it unset to use the official API — an empty value breaks requests. |
+| `ANTHROPIC_MODEL` | No | `claude-sonnet-4-6` | Override the model. An empty or whitespace-only value falls back to the default. |
+
 ### How to Update
 
 Upgrade an installed tool to the latest release:
@@ -67,3 +94,7 @@ Upgrade an installed tool to the latest release:
 ```bash
 uv tool upgrade nanoPyCodeAgent   # or: pipx upgrade nanoPyCodeAgent
 ```
+
+## Releasing
+
+For maintainers: see [docs/RELEASING.md](docs/RELEASING.md) for the release process and prerequisites.

nanopycodeagent-0.3.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+nanopycodeagent/__init__.py,sha256=pYFCw7WNkZsGXbqNLkXituX4iBy86RJ4LKKAr78XwM8,70
+nanopycodeagent/agent.py,sha256=ceIw3HuZD3UHPtyxS3eGbfOE6FrKABcGybFIyOMrcmU,7074
+nanopycodeagent-0.3.0.dist-info/METADATA,sha256=BJqRCUQaABx8q8-MKeMKKkBqUgx-CS6KGvvguADFcPY,3028
+nanopycodeagent-0.3.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+nanopycodeagent-0.3.0.dist-info/entry_points.txt,sha256=4gU7YNzQaf2RKlOdfebOWYNYIUk2LDoyhu3G4Vgole8,57
+nanopycodeagent-0.3.0.dist-info/licenses/LICENSE,sha256=g24TppoiLdeF_1_-Y7H2H_eOavKseWA5utuK83Vq1sA,1067
+nanopycodeagent-0.3.0.dist-info/RECORD,,

{nanopycodeagent-0.1.0.dist-info → nanopycodeagent-0.3.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.30.1
+Generator: hatchling 1.31.0
 Root-Is-Purelib: true
 Tag: py3-none-any

nanopycodeagent-0.1.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-nanopycodeagent/__init__.py,sha256=Id0gZ5s6aGlqx-V_x3Eq8ndB99ltn7lN_f-MWHC6kfU,55
-nanopycodeagent-0.1.0.dist-info/METADATA,sha256=LIT9891DoSO6N6OpC8gvn4SNYFkdlXkP7f5Kt9yCuoI,1794
-nanopycodeagent-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-nanopycodeagent-0.1.0.dist-info/entry_points.txt,sha256=4gU7YNzQaf2RKlOdfebOWYNYIUk2LDoyhu3G4Vgole8,57
-nanopycodeagent-0.1.0.dist-info/licenses/LICENSE,sha256=g24TppoiLdeF_1_-Y7H2H_eOavKseWA5utuK83Vq1sA,1067
-nanopycodeagent-0.1.0.dist-info/RECORD,,