nemocode 0.1.0__tar.gz

nemocode-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Lint
+        run: ruff check src/ tests/
+      - name: Format check
+        run: ruff format --check src/ tests/
+      - name: Test
+        run: pytest tests/ -v --tb=short

nemocode-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Lint
+        run: ruff check src/ tests/
+      - name: Test
+        run: pytest tests/ -v --tb=short
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build package
+        run: |
+          pip install build
+          python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

nemocode-0.1.0/.gitignore

@@ -0,0 +1,53 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Ruff
+.ruff_cache/
+
+# NeMoCode local config
+.nemocode.yaml
+
+# Sessions
+~/.local/share/nemocode/
+
+# Database files
+*.db
+*.sqlite
+
+# Secrets
+.env
+.env.local
+firebase-debug.log
+counterpoint.copilot.db
+CODEX_HANDOFF.md
+scripts/setup_nim_key.sh

nemocode-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES.
+
+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.

nemocode-0.1.0/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: nemocode
+Version: 0.1.0
+Summary: Terminal-first control plane for NVIDIA Nemotron 3 — agentic coding, RAG, doc-ops, and multi-model formations.
+Project-URL: Homepage, https://github.com/Hmbown/NeMoCode
+Project-URL: Repository, https://github.com/Hmbown/NeMoCode
+Project-URL: Documentation, https://github.com/Hmbown/NeMoCode#readme
+Project-URL: Bug Tracker, https://github.com/Hmbown/NeMoCode/issues
+License: MIT
+License-File: LICENSE
+Keywords: agentic-ai,formations,nemocode,nemotron,nim,nvidia
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: anyio>=4.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pygments>=2.17
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: textual>=1.0.0
+Requires-Dist: typer>=0.12
+Provides-Extra: aiq
+Requires-Dist: agentiq>=1.0; extra == 'aiq'
+Provides-Extra: all
+Requires-Dist: faster-whisper>=1.0; extra == 'all'
+Requires-Dist: grpcio>=1.60; extra == 'all'
+Requires-Dist: keyring>=25.0; extra == 'all'
+Requires-Dist: sounddevice>=0.4; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: keyring>=25.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Provides-Extra: keyring
+Requires-Dist: keyring>=25.0; extra == 'keyring'
+Provides-Extra: speech
+Requires-Dist: grpcio>=1.60; extra == 'speech'
+Provides-Extra: voice
+Requires-Dist: faster-whisper>=1.0; extra == 'voice'
+Requires-Dist: sounddevice>=0.4; extra == 'voice'
+Description-Content-Type: text/markdown
+
+# NeMoCode
+
+Agentic coding CLI for [NVIDIA NIM](https://build.nvidia.com). Reads your code, makes edits, runs commands — powered by any model on the NIM API or your own GPU via vLLM.
+
+> **Community project** — not affiliated with or endorsed by NVIDIA.
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Setup
+
+Get a free API key from [build.nvidia.com](https://build.nvidia.com):
+
+```bash
+export NVIDIA_API_KEY="nvapi-..."
+nemo code
+```
+
+Or serve a model locally with [vLLM](https://docs.vllm.ai/) on any NVIDIA GPU:
+
+```bash
+vllm serve nvidia/NVIDIA-Nemotron-Nano-9B-v2 \
+  --trust-remote-code --mamba_ssm_cache_dtype float32 \
+  --enable-auto-tool-choice \
+  --tool-parser-plugin nemotron_toolcall_parser.py \
+  --tool-call-parser nemotron_json
+nemo code -e local-vllm-nano9b
+```
+
+No GPU? Rent one via [Brev](https://console.brev.dev) — L40S from $1.03/hr:
+
+```bash
+nemo setup brev
+```
+
+## Usage
+
+```bash
+nemo code                              # interactive REPL
+nemo code "fix the bug in auth.py" -y  # one-shot, auto-approve tools
+nemo chat "explain this error"         # chat, no tools
+cat log.txt | nemo code "diagnose"     # pipe input
+nemo code -f super-nano "refactor"     # multi-model formation
+```
+
+## Endpoints
+
+Works with any OpenAI-compatible API. Pre-configured:
+
+| Endpoint | Model | Access |
+|----------|-------|--------|
+| `nim-super` | Nemotron 3 Super (12B/120B MoE) | NIM API key |
+| `nim-nano` | Nemotron 3 Nano (3B/30B MoE) | NIM API key |
+| `nim-nano-9b` | Nemotron Nano 9B v2 | NIM API key |
+| `openrouter-super` | Super via OpenRouter | OpenRouter key |
+| `together-super` | Super via Together AI | Together key |
+| `local-vllm-*` | Any model on local vLLM | GPU + vLLM |
+| `local-nim-*` | Local NIM container | GPU + Docker |
+
+## Formations
+
+Multi-model pipelines — Super plans, Nano executes, Super reviews:
+
+```bash
+nemo code -f super-nano "implement caching"
+```
+
+| Formation | Pipeline |
+|-----------|----------|
+| `solo` | Super does everything (default) |
+| `super-nano` | Super plans + reviews, Nano executes |
+| `local` | Nano on local GPU, no internet needed |
+
+## Local GPU setup
+
+```bash
+nemo setup          # show all options
+nemo setup vllm     # vLLM serving guide
+nemo setup nim      # NIM container guide
+nemo setup brev     # rent a cloud GPU
+```
+
+## More commands
+
+```bash
+nemo endpoint ls / test     # manage endpoints
+nemo model ls / show        # inspect model manifests
+nemo formation ls / show    # inspect formations
+nemo hardware recommend     # GPU-based recommendations
+nemo session ls             # past conversations
+nemo obs pricing            # token pricing
+nemo init                   # create .nemocode.yaml
+```
+
+## Contributing
+
+```bash
+pip install -e ".[dev]"
+ruff check src/ tests/ && ruff format --check src/ tests/
+pytest tests/ -v
+```
+
+## License
+
+[MIT](LICENSE). NVIDIA, Nemotron, and NIM are trademarks of NVIDIA Corporation.

nemocode-0.1.0/README.md

@@ -0,0 +1,108 @@
+# NeMoCode
+
+Agentic coding CLI for [NVIDIA NIM](https://build.nvidia.com). Reads your code, makes edits, runs commands — powered by any model on the NIM API or your own GPU via vLLM.
+
+> **Community project** — not affiliated with or endorsed by NVIDIA.
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Setup
+
+Get a free API key from [build.nvidia.com](https://build.nvidia.com):
+
+```bash
+export NVIDIA_API_KEY="nvapi-..."
+nemo code
+```
+
+Or serve a model locally with [vLLM](https://docs.vllm.ai/) on any NVIDIA GPU:
+
+```bash
+vllm serve nvidia/NVIDIA-Nemotron-Nano-9B-v2 \
+  --trust-remote-code --mamba_ssm_cache_dtype float32 \
+  --enable-auto-tool-choice \
+  --tool-parser-plugin nemotron_toolcall_parser.py \
+  --tool-call-parser nemotron_json
+nemo code -e local-vllm-nano9b
+```
+
+No GPU? Rent one via [Brev](https://console.brev.dev) — L40S from $1.03/hr:
+
+```bash
+nemo setup brev
+```
+
+## Usage
+
+```bash
+nemo code                              # interactive REPL
+nemo code "fix the bug in auth.py" -y  # one-shot, auto-approve tools
+nemo chat "explain this error"         # chat, no tools
+cat log.txt | nemo code "diagnose"     # pipe input
+nemo code -f super-nano "refactor"     # multi-model formation
+```
+
+## Endpoints
+
+Works with any OpenAI-compatible API. Pre-configured:
+
+| Endpoint | Model | Access |
+|----------|-------|--------|
+| `nim-super` | Nemotron 3 Super (12B/120B MoE) | NIM API key |
+| `nim-nano` | Nemotron 3 Nano (3B/30B MoE) | NIM API key |
+| `nim-nano-9b` | Nemotron Nano 9B v2 | NIM API key |
+| `openrouter-super` | Super via OpenRouter | OpenRouter key |
+| `together-super` | Super via Together AI | Together key |
+| `local-vllm-*` | Any model on local vLLM | GPU + vLLM |
+| `local-nim-*` | Local NIM container | GPU + Docker |
+
+## Formations
+
+Multi-model pipelines — Super plans, Nano executes, Super reviews:
+
+```bash
+nemo code -f super-nano "implement caching"
+```
+
+| Formation | Pipeline |
+|-----------|----------|
+| `solo` | Super does everything (default) |
+| `super-nano` | Super plans + reviews, Nano executes |
+| `local` | Nano on local GPU, no internet needed |
+
+## Local GPU setup
+
+```bash
+nemo setup          # show all options
+nemo setup vllm     # vLLM serving guide
+nemo setup nim      # NIM container guide
+nemo setup brev     # rent a cloud GPU
+```
+
+## More commands
+
+```bash
+nemo endpoint ls / test     # manage endpoints
+nemo model ls / show        # inspect model manifests
+nemo formation ls / show    # inspect formations
+nemo hardware recommend     # GPU-based recommendations
+nemo session ls             # past conversations
+nemo obs pricing            # token pricing
+nemo init                   # create .nemocode.yaml
+```
+
+## Contributing
+
+```bash
+pip install -e ".[dev]"
+ruff check src/ tests/ && ruff format --check src/ tests/
+pytest tests/ -v
+```
+
+## License
+
+[MIT](LICENSE). NVIDIA, Nemotron, and NIM are trademarks of NVIDIA Corporation.