novacode-cli 1.2.0__tar.gz

novacode_cli-1.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Harrison Chase
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

novacode_cli-1.2.0/PKG-INFO

@@ -0,0 +1,271 @@
+Metadata-Version: 2.4
+Name: novacode-cli
+Version: 1.2.0
+Summary: Agentic Coding Tool that runs in your terminal
+Author-email: Babitdor <babitdorbryan14@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Babitdor/NovaCode
+Project-URL: Repository, https://github.com/Babitdor/NovaCode
+Project-URL: Issues, https://github.com/Babitdor/NovaCode/issues
+Project-URL: Changelog, https://github.com/Babitdor/NovaCode/blob/main/CHANGELOG.md
+Keywords: nova,code-cli,nova-code,agentic-code-cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: <4.0,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: certifi>=2026.10.19
+Requires-Dist: brotli>=1.2.1
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual>=1.0.0
+Requires-Dist: psutil>=5.9
+Requires-Dist: pyte<0.9,>=0.8.2
+Requires-Dist: pywinpty<3,>=2.0.15; sys_platform == "win32"
+Requires-Dist: langchain>=1.2.13
+Requires-Dist: langchain-core>=1.2.22
+Requires-Dist: langchain-openai>=1.0.0
+Requires-Dist: langchain-anthropic>=1.4.0
+Requires-Dist: langchain-ollama>=1.0.1
+Requires-Dist: langchain-google-genai>=4.2.1
+Requires-Dist: google-auth>=2.40
+Requires-Dist: google-auth-oauthlib>=1.2.2
+Requires-Dist: langchain-nvidia-ai-endpoints>=1.4.1
+Requires-Dist: langchain-mcp-adapters>=0.2.2
+Requires-Dist: langgraph>=1.1.3
+Requires-Dist: langgraph-checkpoint-sqlite>=2.0.0
+Requires-Dist: langsmith>=0.7.22
+Requires-Dist: tavily-python
+Requires-Dist: deepagents<0.8,>=0.7.0
+Requires-Dist: python-dotenv
+Requires-Dist: daytona>=0.113.0
+Requires-Dist: modal>=0.65.0
+Requires-Dist: markdownify>=0.13.0
+Requires-Dist: runloop-api-client>=0.69.0
+Requires-Dist: mcp<2,>=1.28.1
+Requires-Dist: docker>=7.0.0
+Requires-Dist: keyring>=24.0.0
+Requires-Dist: pillow>=13.0.0
+Requires-Dist: aiosqlite>=0.19.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: ddgs>=7.0.0
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: httpx>=0.27
+Requires-Dist: PyJWT[crypto]>=2.10
+Requires-Dist: pydantic>=2.0
+Requires-Dist: jsonschema>=4.18
+Requires-Dist: referencing>=0.28.4
+Requires-Dist: regex>=2024.11.6
+Requires-Dist: pymupdf>=1.24
+Requires-Dist: bm25s>=0.2
+Requires-Dist: graphifyy>=0.4.0
+Requires-Dist: semble>=0.1.8
+Requires-Dist: discord.py>=2.3.0
+Requires-Dist: python-telegram-bot>=21.0.0
+Requires-Dist: langchain-quickjs==0.3.2
+Requires-Dist: dill>=0.3.8
+Requires-Dist: langchain-typesafe>=0.0.1a3
+Provides-Extra: browser
+Requires-Dist: browser-use>=0.1.0; extra == "browser"
+Requires-Dist: playwright>=1.40.0; extra == "browser"
+Provides-Extra: voice
+Requires-Dist: faster-whisper>=1.0.0; extra == "voice"
+Requires-Dist: silero-vad>=5.1; extra == "voice"
+Requires-Dist: piper-tts>=1.2.0; extra == "voice"
+Requires-Dist: sounddevice>=0.4.6; extra == "voice"
+Provides-Extra: voice-orpheus
+Requires-Dist: orpheus-cpp==0.0.3; extra == "voice-orpheus"
+Requires-Dist: llama-cpp-python>=0.3.0; extra == "voice-orpheus"
+Provides-Extra: voice-parakeet
+Requires-Dist: sherpa-onnx<2,>=1.10.0; extra == "voice-parakeet"
+Provides-Extra: voice-pocket
+Requires-Dist: pocket-tts>=0.1.0; extra == "voice-pocket"
+Provides-Extra: bedrock
+Requires-Dist: langchain-aws>=1.0.0; extra == "bedrock"
+Provides-Extra: server
+Requires-Dist: fastapi>=0.115.0; extra == "server"
+Requires-Dist: uvicorn>=0.34.0; extra == "server"
+Provides-Extra: agents-server
+Requires-Dist: langgraph-cli[inmem]; extra == "agents-server"
+Provides-Extra: voice-whistle
+Requires-Dist: cactus-needle<4,>=3.2.1; extra == "voice-whistle"
+Provides-Extra: voice-kokoro
+Requires-Dist: kokoro-onnx==0.4.9; extra == "voice-kokoro"
+Provides-Extra: voice-sano
+Requires-Dist: sanotts==0.3.0; extra == "voice-sano"
+Provides-Extra: computer
+Requires-Dist: cua==0.9.0; extra == "computer"
+Dynamic: license-file
+
+![NovaCode banner](assets/Nova.png)
+
+# NovaCode
+
+An open-source terminal coding assistant that reads your project, plans changes,
+edits files and runs checks. Choose cloud or local models and keep useful project
+knowledge between sessions.
+
+Built with Python, LangGraph, deepagents and Textual. [MIT licensed](LICENSE).
+
+![NovaCode terminal in Classic style](assets/Preview-classic.png)
+
+## Get started
+
+Requires **Python 3.11+**, **Git** and **uv**, plus a supported model provider or
+a running Ollama instance with a model installed.
+
+```bash
+git clone https://github.com/Babitdor/NovaCode.git
+cd NovaCode
+uv sync
+uv run nova
+```
+
+First-run setup guides provider configuration and workspace approval. Hosted
+models may charge for usage. To install a global `nova` command from this checkout,
+run `uv tool install .`, then launch `nova` from your project directory.
+
+## What Nova can do
+
+- **Code and verify:** investigate projects, edit files, run commands and checks,
+  and review changes with workspace and tool approvals.
+- **Plan and delegate:** compare Council proposals, use specialist agents and
+  coordinate project tabs with messages and Git worktrees.
+- **Remember:** inspect and maintain a linked Markdown memory wiki, resume
+  sessions and recover supported file snapshots.
+- **Choose and extend:** select hosted or local models, configure an independent
+  vision model, and add skills, plugins and MCP servers.
+- **Compose tools in Code Mode:** toggle it below the composer to combine
+  eligible native and MCP tools in bounded JavaScript workflows.
+- **Speak and listen:** optional speech input and short spoken reply summaries,
+  including lightweight CPU voice choices and model download progress.
+- **Make it yours:** choose from 13 interface styles, including character art
+  and optional animated home scenes.
+- **Work beyond the terminal:** use remote chats, local web workspaces, temporary
+  artifact previews and headless automation.
+
+See [FEATURES.md](FEATURES.md) for the full catalog, setup requirements and
+landing-page copy.
+
+## Everyday use
+
+| Command | Purpose |
+| --- | --- |
+| `/help` | Commands and keyboard shortcuts |
+| `/onboard` | Interactive code map, guided tours, architecture guide, Q&A and change impact |
+| `/model`, `/auth` | Models, vision and provider access |
+| `/plan`, `/council <task>` | Investigate changes and compare plans |
+| `/tabs`, `/resume` | Parallel projects and saved sessions |
+| `/dream`, `/context` | Memory maintenance and context inspection |
+| `/settings`, `/theme` | Voice, interface styles and preferences |
+| `/mcp`, `/remote` | External tools and remote chat setup |
+| `/restore` | Recoverable file snapshots |
+
+Attach files with `@`; use **Shift+Enter** for a new line. For a one-shot task:
+
+```bash
+uv run nova -p "Summarize the changes in this repository"
+```
+
+**New to a project? Start with `/onboard`.** Inspired by
+[Understand Anything](https://github.com/Egonex-AI/Understand-Anything), it parses
+the local workspace with the already installed Graphify language parsers and
+saves a persistent graph and guide in `.nova/onboard/`. The local artifact
+dashboard provides file/symbol search, directory filters, a clickable dependency
+map, a learning tour and incoming dependency impact tracing. It needs no Node
+installation, browser credentials or external dashboard assets.
+
+Use `/onboard open` to reopen the dashboard, `/onboard tour` for a conversational
+tour, `/onboard ask <question>` for source-grounded Q&A, and
+`/onboard impact <symbol or path>` before changing code. The dashboard's **Ask
+Nova** tab prepares a command to paste into the conversation. Nova explains the
+architecture and business flows using its normal model and tool permissions;
+the initial deterministic guide contains structural facts only. Reopen the
+dashboard after Nova enriches the guide. Model calls use your configured provider.
+
+`/onboard refresh` rebuilds after changes. File-content fingerprints detect
+new, edited and deleted inputs; saved analyses display a staleness notice.
+Scans respect Git ignore rules and skip links, generated directories and common
+secret filenames. Static parsing can miss dynamic dependencies; directory
+groups are not semantic architecture layers. Limits: 5,000 source/Markdown
+files, 1 MiB per file, 64 MiB total input and 32 MiB graph. The parsing deadline
+scales with file count and input size from two to ten minutes; Escape cancels it.
+Refresh replaces generated graph/guide files, so copy edited guides
+elsewhere before rebuilding. This command currently requires a local workspace;
+Plan Mode prevents building or refreshing the saved analysis.
+
+## Optional features
+
+Install selected extras from this checkout, for example:
+
+```bash
+uv sync --extra voice --extra voice-kokoro
+```
+
+Keep all desired `--extra` flags when syncing. Speech models download on first
+use. See [setup and usage](SETUP.md) for global installation, voice providers,
+browser automation and background-agent requirements.
+
+**Local computer preview:** the `computer` extra lets Nova operate a
+separate Linux QEMU VM with a private live browser preview and pause/resume/stop
+controls. Requires QEMU, a guest-image download and 4 GiB RAM for the guest.
+Start with `/computer start`; see [computer setup and limits](COMPUTER.md).
+The Windows WHPX compatibility fix in this checkout has passed a real desktop boot.
+
+## Documentation and contributing
+
+[Setup and usage](SETUP.md) · [Feature catalog](FEATURES.md) ·
+[Code Mode](docs/mcp-code-mode.md) · [Permissions](docs/security-guardrails.md) ·
+[Sharing](docs/temporary-sharing.md) · [Changelog](changelog/)
+
+For development, run `uv sync --group dev` and tests relevant to your change.
+See [project instructions](AGENTS.md) for build and check commands. Report bugs
+or propose changes through repository issues and pull requests.
+
+
+### Compression preferences
+
+The composer selector cycles **Off → Caveman → Ponytail → Off**. Options saves
+mode, independent intensities and Caveman feature switches together; Escape discards
+edits. Preferences persist across restarts. Existing Caveman settings migrate automatically.
+Mode changes use temporary notifications and never submit your draft.
+
+- `/caveman on|off|lite|full|ultra|wenyan-lite|wenyan-full|wenyan-ultra`
+- `/ponytail` activates Ponytail without resetting its selected intensity.
+- `/ponytail lite|full|ultra|off|settings|status`
+- `/ponytail-review [scope]`, `/ponytail-audit [scope]`, `/ponytail-debt [scope]`,
+  `/ponytail-gain`, `/ponytail-help` run the corresponding one-shot helper without
+  changing the selected mode. Review and audit request reports, not edits.
+- A standalone `stop ponytail` or `normal mode` disables Ponytail. Those phrases
+  inside an ordinary task do not change preferences.
+
+Caveman compresses prose and optionally tool views. Ponytail applies the upstream
+coding rules: solve the complete problem with the least new code, preserve necessary
+checks, and name skipped work and risks. Ponytail leaves tool results intact and
+also applies to delegated model requests. Neither mode changes tool permissions.
+Savings depend on the task and model; shorter output is not guaranteed.
+
+Ponytail's MIT-licensed skill bodies and JavaScript instruction builder are vendored
+from [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail) at
+`09c434ab73ca43761c5d8b0c5d341926c2fba710`. Nova's Python builder is checked
+against golden hashes from that JavaScript builder. Nova owns the persistent selector;
+upstream Claude-specific band, board, install hooks and default-mode files are not used.
+There is no Node runtime requirement.
+
+To validate every compression intensity against your configured LLM (20 paid/provider
+calls, concurrency two, 60-second timeout each), run:
+
+```sh
+uv run python -m scripts.verify_compression_live
+```
+
+This opt-in check preserves exact failure facts/commands and validates generated
+Python on boundary and invalid-bound cases. It writes synthetic outputs and reported
+usage (or `unknown`) to `test-results/compression-live.json`, without changing your
+preferences. Offline tests never call an LLM. Golden parity proves prompt equivalence;
+it cannot guarantee identical stochastic model responses.

novacode_cli-1.2.0/README.md

@@ -0,0 +1,167 @@
+![NovaCode banner](assets/Nova.png)
+
+# NovaCode
+
+An open-source terminal coding assistant that reads your project, plans changes,
+edits files and runs checks. Choose cloud or local models and keep useful project
+knowledge between sessions.
+
+Built with Python, LangGraph, deepagents and Textual. [MIT licensed](LICENSE).
+
+![NovaCode terminal in Classic style](assets/Preview-classic.png)
+
+## Get started
+
+Requires **Python 3.11+**, **Git** and **uv**, plus a supported model provider or
+a running Ollama instance with a model installed.
+
+```bash
+git clone https://github.com/Babitdor/NovaCode.git
+cd NovaCode
+uv sync
+uv run nova
+```
+
+First-run setup guides provider configuration and workspace approval. Hosted
+models may charge for usage. To install a global `nova` command from this checkout,
+run `uv tool install .`, then launch `nova` from your project directory.
+
+## What Nova can do
+
+- **Code and verify:** investigate projects, edit files, run commands and checks,
+  and review changes with workspace and tool approvals.
+- **Plan and delegate:** compare Council proposals, use specialist agents and
+  coordinate project tabs with messages and Git worktrees.
+- **Remember:** inspect and maintain a linked Markdown memory wiki, resume
+  sessions and recover supported file snapshots.
+- **Choose and extend:** select hosted or local models, configure an independent
+  vision model, and add skills, plugins and MCP servers.
+- **Compose tools in Code Mode:** toggle it below the composer to combine
+  eligible native and MCP tools in bounded JavaScript workflows.
+- **Speak and listen:** optional speech input and short spoken reply summaries,
+  including lightweight CPU voice choices and model download progress.
+- **Make it yours:** choose from 13 interface styles, including character art
+  and optional animated home scenes.
+- **Work beyond the terminal:** use remote chats, local web workspaces, temporary
+  artifact previews and headless automation.
+
+See [FEATURES.md](FEATURES.md) for the full catalog, setup requirements and
+landing-page copy.
+
+## Everyday use
+
+| Command | Purpose |
+| --- | --- |
+| `/help` | Commands and keyboard shortcuts |
+| `/onboard` | Interactive code map, guided tours, architecture guide, Q&A and change impact |
+| `/model`, `/auth` | Models, vision and provider access |
+| `/plan`, `/council <task>` | Investigate changes and compare plans |
+| `/tabs`, `/resume` | Parallel projects and saved sessions |
+| `/dream`, `/context` | Memory maintenance and context inspection |
+| `/settings`, `/theme` | Voice, interface styles and preferences |
+| `/mcp`, `/remote` | External tools and remote chat setup |
+| `/restore` | Recoverable file snapshots |
+
+Attach files with `@`; use **Shift+Enter** for a new line. For a one-shot task:
+
+```bash
+uv run nova -p "Summarize the changes in this repository"
+```
+
+**New to a project? Start with `/onboard`.** Inspired by
+[Understand Anything](https://github.com/Egonex-AI/Understand-Anything), it parses
+the local workspace with the already installed Graphify language parsers and
+saves a persistent graph and guide in `.nova/onboard/`. The local artifact
+dashboard provides file/symbol search, directory filters, a clickable dependency
+map, a learning tour and incoming dependency impact tracing. It needs no Node
+installation, browser credentials or external dashboard assets.
+
+Use `/onboard open` to reopen the dashboard, `/onboard tour` for a conversational
+tour, `/onboard ask <question>` for source-grounded Q&A, and
+`/onboard impact <symbol or path>` before changing code. The dashboard's **Ask
+Nova** tab prepares a command to paste into the conversation. Nova explains the
+architecture and business flows using its normal model and tool permissions;
+the initial deterministic guide contains structural facts only. Reopen the
+dashboard after Nova enriches the guide. Model calls use your configured provider.
+
+`/onboard refresh` rebuilds after changes. File-content fingerprints detect
+new, edited and deleted inputs; saved analyses display a staleness notice.
+Scans respect Git ignore rules and skip links, generated directories and common
+secret filenames. Static parsing can miss dynamic dependencies; directory
+groups are not semantic architecture layers. Limits: 5,000 source/Markdown
+files, 1 MiB per file, 64 MiB total input and 32 MiB graph. The parsing deadline
+scales with file count and input size from two to ten minutes; Escape cancels it.
+Refresh replaces generated graph/guide files, so copy edited guides
+elsewhere before rebuilding. This command currently requires a local workspace;
+Plan Mode prevents building or refreshing the saved analysis.
+
+## Optional features
+
+Install selected extras from this checkout, for example:
+
+```bash
+uv sync --extra voice --extra voice-kokoro
+```
+
+Keep all desired `--extra` flags when syncing. Speech models download on first
+use. See [setup and usage](SETUP.md) for global installation, voice providers,
+browser automation and background-agent requirements.
+
+**Local computer preview:** the `computer` extra lets Nova operate a
+separate Linux QEMU VM with a private live browser preview and pause/resume/stop
+controls. Requires QEMU, a guest-image download and 4 GiB RAM for the guest.
+Start with `/computer start`; see [computer setup and limits](COMPUTER.md).
+The Windows WHPX compatibility fix in this checkout has passed a real desktop boot.
+
+## Documentation and contributing
+
+[Setup and usage](SETUP.md) · [Feature catalog](FEATURES.md) ·
+[Code Mode](docs/mcp-code-mode.md) · [Permissions](docs/security-guardrails.md) ·
+[Sharing](docs/temporary-sharing.md) · [Changelog](changelog/)
+
+For development, run `uv sync --group dev` and tests relevant to your change.
+See [project instructions](AGENTS.md) for build and check commands. Report bugs
+or propose changes through repository issues and pull requests.
+
+
+### Compression preferences
+
+The composer selector cycles **Off → Caveman → Ponytail → Off**. Options saves
+mode, independent intensities and Caveman feature switches together; Escape discards
+edits. Preferences persist across restarts. Existing Caveman settings migrate automatically.
+Mode changes use temporary notifications and never submit your draft.
+
+- `/caveman on|off|lite|full|ultra|wenyan-lite|wenyan-full|wenyan-ultra`
+- `/ponytail` activates Ponytail without resetting its selected intensity.
+- `/ponytail lite|full|ultra|off|settings|status`
+- `/ponytail-review [scope]`, `/ponytail-audit [scope]`, `/ponytail-debt [scope]`,
+  `/ponytail-gain`, `/ponytail-help` run the corresponding one-shot helper without
+  changing the selected mode. Review and audit request reports, not edits.
+- A standalone `stop ponytail` or `normal mode` disables Ponytail. Those phrases
+  inside an ordinary task do not change preferences.
+
+Caveman compresses prose and optionally tool views. Ponytail applies the upstream
+coding rules: solve the complete problem with the least new code, preserve necessary
+checks, and name skipped work and risks. Ponytail leaves tool results intact and
+also applies to delegated model requests. Neither mode changes tool permissions.
+Savings depend on the task and model; shorter output is not guaranteed.
+
+Ponytail's MIT-licensed skill bodies and JavaScript instruction builder are vendored
+from [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail) at
+`09c434ab73ca43761c5d8b0c5d341926c2fba710`. Nova's Python builder is checked
+against golden hashes from that JavaScript builder. Nova owns the persistent selector;
+upstream Claude-specific band, board, install hooks and default-mode files are not used.
+There is no Node runtime requirement.
+
+To validate every compression intensity against your configured LLM (20 paid/provider
+calls, concurrency two, 60-second timeout each), run:
+
+```sh
+uv run python -m scripts.verify_compression_live
+```
+
+This opt-in check preserves exact failure facts/commands and validates generated
+Python on boundary and invalid-bound cases. It writes synthetic outputs and reported
+usage (or `unknown`) to `test-results/compression-live.json`, without changing your
+preferences. Offline tests never call an LLM. Golden parity proves prompt equivalence;
+it cannot guarantee identical stochastic model responses.

novacode_cli-1.2.0/novacode_cli/__init__.py

@@ -0,0 +1,29 @@
+"""NOVA CLI - Interactive AI coding assistant."""
+
+import os as _os
+
+# Must run before numpy is imported anywhere in the process. numpy's OpenBLAS
+# pre-allocates a buffer per CPU thread at import: on a 12-thread machine that
+# is ~380 MB of private memory for nothing — Nova's numeric work is small
+# vector searches (skill and code retrieval over a few thousand 256-d rows),
+# where one thread is measurably FASTER (91 us vs 180 us for a 1000-row
+# search) because thread hand-off costs more than the arithmetic. One thread:
+# ~9 MB. It applies to every Nova process — the TUI and each spawned session.
+# setdefault, so an explicit setting in the environment still wins.
+_os.environ.setdefault("OPENBLAS_NUM_THREADS", "1")
+# Other numerical backends also default to machine-wide thread pools. Multiple
+# Nova processes should not each occupy every core; explicit user values win.
+_os.environ.setdefault("OMP_NUM_THREADS", "1")
+_os.environ.setdefault("MKL_NUM_THREADS", "1")
+_os.environ.setdefault("NUMEXPR_NUM_THREADS", "1")
+
+# Must run before langchain_core is imported: it pulls in `transformers` (and
+# therefore torch/numpy/PIL) at module scope for a fallback tokenizer Nova never
+# uses, costing ~160 MB RSS and ~10 s of startup. See novacode_cli._lazy_heavy.
+from novacode_cli import _lazy_heavy as _lazy_heavy
+
+_lazy_heavy.install()
+
+# from novacode_cli.main import cli_main
+
+__all__ = []

novacode_cli-1.2.0/novacode_cli/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running the CLI as: python -m deepagents.cli."""
+
+from novacode_cli.entrypoint import cli_main
+
+if __name__ == "__main__":
+    cli_main()

novacode_cli-1.2.0/novacode_cli/_lazy_heavy.py

@@ -0,0 +1,99 @@
+"""Keep `transformers`/`torch` out of Nova's startup import graph.
+
+``langchain_core.language_models.base`` does, at module scope::
+
+    try:
+        from transformers import GPT2TokenizerFast
+        _HAS_TRANSFORMERS = True
+    except ImportError:
+        _HAS_TRANSFORMERS = False
+
+That import is only ever used for a *fallback* GPT-2 token counter
+(``_get_token_ids_default_method``), but ``transformers`` eagerly pulls in
+``torch``, ``numpy``, ``huggingface_hub`` and ``PIL``. Measured on this project:
+
+    full import of novacode_cli.main   305 MB RSS, ~13 s, 4056 modules
+    with transformers/torch excluded   145 MB RSS, ~2.4 s, 3053 modules
+
+Nova talks to hosted model APIs and takes token counts from the provider
+(``get_num_tokens_from_messages``, with char-based fallbacks at every call
+site), so it never needs the GPT-2 tokenizer. Paying 160 MB of resident memory
+and ~10 s of startup for it caused real problems on memory-constrained machines
+(paging-file exhaustion, failed subprocess spawns).
+
+This installs a meta-path finder that makes ``import transformers`` raise
+``ImportError`` — the exact exception langchain_core already handles — so it
+cleanly takes the ``_HAS_TRANSFORMERS = False`` branch.
+
+Escape hatch: set ``NOVA_ALLOW_TRANSFORMERS=1`` to disable the guard. Anything
+that genuinely needs the library (a local HF model, say) can also call
+:func:`allow_transformers` first.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from typing import Any
+
+#: Top-level packages kept out of the startup graph.
+_BLOCKED = frozenset({"transformers", "torch"})
+
+_ENV_OPT_OUT = "NOVA_ALLOW_TRANSFORMERS"
+
+
+class _HeavyImportGuard:
+    """Meta-path finder that refuses the heavy optional deps.
+
+    Raising ``ImportError`` (rather than returning ``None``) is deliberate: the
+    consumers of these packages all wrap the import in ``try/except
+    ImportError`` and degrade gracefully. Returning ``None`` would just let the
+    real finder load them.
+    """
+
+    def find_spec(self, name: str, path: Any = None, target: Any = None) -> None:  # noqa: ANN401, ARG002
+        if name.split(".")[0] in _BLOCKED:
+            msg = (
+                f"{name!r} is not imported at Nova startup (it costs ~160 MB of "
+                f"resident memory and is only needed for a fallback tokenizer). "
+                f"Set {_ENV_OPT_OUT}=1 if you really need it."
+            )
+            raise ImportError(msg)
+        return None
+
+
+_guard: _HeavyImportGuard | None = None
+
+
+def install() -> bool:
+    """Install the guard. Returns True if it is now active.
+
+    No-ops when the user opted out, or when the packages are already imported
+    (blocking then would be pointless — the memory is already committed).
+    """
+    global _guard
+    if os.environ.get(_ENV_OPT_OUT, "").strip().lower() in ("1", "true", "yes"):
+        return False
+    if _guard is not None:
+        return True
+    if any(mod in sys.modules for mod in _BLOCKED):
+        return False
+    _guard = _HeavyImportGuard()
+    sys.meta_path.insert(0, _guard)
+    return True
+
+
+def allow_transformers() -> None:
+    """Remove the guard so ``transformers``/``torch`` can be imported again."""
+    global _guard
+    if _guard is not None:
+        try:
+            sys.meta_path.remove(_guard)
+        except ValueError:
+            pass
+        _guard = None
+
+
+def is_active() -> bool:
+    """Whether the guard is currently installed."""
+    return _guard is not None

novacode_cli-1.2.0/novacode_cli/_version.py

@@ -0,0 +1,3 @@
+"""Version information for NOVA CLI."""
+
+__version__ = "1.2.0"