neuralnode 2.2.7__tar.gz → 2.2.9__tar.gz

{neuralnode-2.2.7 → neuralnode-2.2.9}/.env.example

@@ -1,26 +1,22 @@
-# NeuralNode Environment Configuration
-# Copy this file to .env and fill in your API keys
-
-# OpenAI Configuration
-OPENAI_API_KEY=sk-your-openai-api-key-here
-OPENAI_BASE_URL=https://api.openai.com/v1
-
-# Anthropic Configuration
-ANTHROPIC_API_KEY=sk-ant-your-anthropic-api-key-here
-
-# Google (Gemini) Configuration
-GOOGLE_API_KEY=your-google-api-key-here
-
-# Ollama Configuration (for local models)
-# No API key needed, just ensure Ollama is running
-OLLAMA_BASE_URL=http://localhost:11434
-
-# Horus Cyper Nano 1.0 BETA Early Access
-HORUS_CYPER_NANO_API_KEY=horusNN-your-access-token
-HORUS_CYPER_NANO_BASE_URL=https://api.tokenai.llc/v1
-
-# NeuralNode Settings
-NEURALNODE_DEFAULT_PROVIDER=auto
-NEURALNODE_MEMORY_ENABLED=true
-NEURALNODE_SAFE_MODE=true
-NEURALNODE_LOG_LEVEL=INFO
+# NeuralNode Environment Configuration
+# Copy this file to .env and fill in your API keys
+
+# OpenAI Configuration
+OPENAI_API_KEY=sk-your-openai-api-key-here
+OPENAI_BASE_URL=https://api.openai.com/v1
+
+# Anthropic Configuration
+ANTHROPIC_API_KEY=sk-ant-your-anthropic-api-key-here
+
+# Google (Gemini) Configuration
+GOOGLE_API_KEY=your-google-api-key-here
+
+# Ollama Configuration (for local models)
+# No API key needed, just ensure Ollama is running
+OLLAMA_BASE_URL=http://localhost:11434
+
+# NeuralNode Settings
+NEURALNODE_DEFAULT_PROVIDER=auto
+NEURALNODE_MEMORY_ENABLED=true
+NEURALNODE_SAFE_MODE=true
+NEURALNODE_LOG_LEVEL=INFO

neuralnode-2.2.9/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,15 @@
+## Summary
+
+Describe the problem and the change made.
+
+## Validation
+
+- [ ] I ran the relevant tests and checks.
+- [ ] I added or updated tests where appropriate.
+- [ ] I did not include secrets, credentials, or private data.
+- [ ] I have read and agree to [TOKENAI_CLA.md](../TOKENAI_CLA.md).
+- [ ] I have identified any third-party code, data, or assets included in this PR.
+
+## Notes for review
+
+Add compatibility notes, migration details, or known limitations here.

neuralnode-2.2.9/.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions: {}
+
+jobs:
+  publish:
+    if: github.event.release.prerelease == false
+    runs-on: ubuntu-24.04
+    environment:
+      name: pypi
+      url: https://pypi.org/p/neuralnode
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - name: Build source distribution and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+
+      - name: Publish package distributions
+        uses: pypa/gh-action-pypi-publish@release/v1

neuralnode-2.2.9/.github/workflows/tests.yml

@@ -0,0 +1,86 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Python
+      uses: actions/setup-python@v7
+      with:
+        python-version: "3.12"
+
+    - name: Install build tools
+      run: python -m pip install --upgrade build twine
+
+    - name: Build source distribution and wheel
+      run: python -m build --outdir .ci-dist
+
+    - name: Validate package metadata
+      run: python -m twine check .ci-dist/*
+
+    - name: Install wheel and verify package version
+      run: |
+        python -m pip install --force-reinstall .ci-dist/*.whl
+        python -c "import neuralnode; assert neuralnode.__version__ == '2.2.9'; print(neuralnode.__version__)"
+
+  test:
+    # Python 3.9 is no longer available on the newest Ubuntu runner image.
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v7
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Run tests
+      run: |
+        pytest tests/ -v --cov=src/neuralnode --cov-report=xml --cov-report=term
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v7
+      with:
+        files: ./coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+
+  lint:
+    runs-on: ubuntu-24.04
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Python
+      uses: actions/setup-python@v7
+      with:
+        python-version: "3.11"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install black ruff mypy
+
+    - name: Check formatting with black
+      run: black --check src/neuralnode
+
+    # The legacy tree has broad style/type debt; keep CI focused on undefined
+    # names while that debt is addressed incrementally.
+    - name: Check undefined names with ruff
+      run: ruff check src/neuralnode --select F821

neuralnode-2.2.9/.gitignore

@@ -0,0 +1,41 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.egg-info/
+dist/
+release-dist/
+.release-dist*/
+.ci-dist/
+.ci-dist-verify*/
+.install-check*/
+build/
+.eggs/
+
+# Virtual envs
+.venv/
+venv/
+env/
+
+# Local credentials and environment files
+.env
+.env.*
+!.env.example
+**/.env
+**/.env.*
+!**/.env.example
+
+# Temp / outputs
+outputs/
+.tmp_*
+*.gguf.tmp
+
+# Test caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db

neuralnode-2.2.9/CHANGELOG.md

@@ -0,0 +1,89 @@
+# Changelog
+
+All notable changes to NeuralNode are documented here.
+
+## 2.2.9 — 2026-11-01
+
+### Integrations and runtime cleanup
+
+- Removed the deprecated WhatsApp/Twilio integration and legacy API gateway.
+- Removed obsolete provider and deployment artifacts from the maintained core.
+- Updated the OpenClaw manager for the current OpenClaw configuration schema,
+  loopback-only gateway binding, token authentication, and OpenAI-compatible
+  chat-completions enablement.
+- Added a blocking-chat fallback for OpenClaw streaming requests so providers
+  without native streaming can still complete gateway turns.
+- Validated the NeuralNode → OpenClaw → local Qwen/llama.cpp path on AWS.
+- Upgraded Ollama chat integration to the native `/api/chat` protocol with
+  role-preserving messages, streaming, structured output, and tool calls.
+- Added Ollama native reasoning control through `thinking=True` or
+  `thinking=False`, preserving the model trace in response metadata.
+- Updated Ollama embeddings to the batch `/api/embed` endpoint with a legacy
+  compatibility fallback.
+- Removed the remaining Twilio optional dependency with the retired WhatsApp
+  integration.
+
+## 2.2.8 — 2026-11-01
+
+NeuralNode 2.2.8 is a feature and reliability release focused on local model
+execution, multimodal workflows, integrations, and reproducible packaging.
+
+### Multimodal and local model support
+
+- Added local Hugging Face speech adapters:
+  - `HuggingFaceSTT` for audio transcription.
+  - `HuggingFaceTTS` for text-to-speech generation.
+- Added configurable Hugging Face model IDs, lazy loading, language handling,
+  CPU/CUDA device selection, and WAV output for the speech adapters.
+- Added local vision-language input support through the existing image chat
+  interface.
+- Added Diffusers-compatible local text-to-image loading and generation.
+- Improved local model generation determinism and provider identity.
+- Improved model repository download handling for Hugging Face sources.
+- Added explicit authentication support for private and gated Hugging Face
+  repositories using `HF_TOKEN` or an explicit token parameter.
+- Made optional Horus runtime imports tolerant of environments where the heavy
+  local ML dependencies are not installed.
+
+### Voice workflows
+
+- Added a sequential `VoiceAgent` pipeline for file-based and push-to-talk
+  interactions:
+
+  `audio input → speech-to-text → agent/LLM turn → text-to-speech → audio output`
+
+- Added HTTP speech adapters for connecting external STT and TTS services.
+- Documented the distinction between sequential voice turns and low-latency,
+  full-duplex live audio. Full-duplex streaming is outside this release.
+
+### Agents and tools
+
+- Improved provider-backed agent tool calling.
+- Added support for textual actions from tool-capable models.
+- Improved tool-result message handling and buffered streaming compatibility.
+- Preserved the existing agents, memory, RAG, embeddings, vector-store, and
+  integration APIs.
+
+### Horus and OpenClaw
+
+- Aligned Horus and OpenClaw integrations with the current public interfaces.
+- Secured the OpenClaw local API behavior.
+- Added test paths that do not require optional OpenClaw HTTP test packages.
+### Release engineering
+
+- Added source distribution and wheel build validation in CI.
+- Isolated package build output from repository working files.
+- Added trusted PyPI publishing through GitHub Actions and PyPI's OIDC
+  trusted-publishing flow.
+- Added public repository, ownership, license, and release metadata alignment.
+
+### Compatibility and limitations
+
+- Python 3.9, 3.10, 3.11, and 3.12 are supported by the package metadata.
+- Heavy local-model, image, and speech features remain optional extras; the
+  base installation does not install those large runtime dependencies.
+- Public Hugging Face models can be loaded without a token. Private or gated
+  repositories require a valid `HF_TOKEN`.
+- The voice pipeline in this release processes one turn at a time. It is not a
+  real-time, full-duplex audio session.
+

neuralnode-2.2.9/CONTRIBUTING.md

@@ -0,0 +1,40 @@
+# Contributing to NeuralNode
+
+Thank you for helping improve NeuralNode. Contributions may be submitted by
+opening an issue, creating a fork, or opening a pull request.
+
+## Pull request workflow
+
+1. Create a focused branch or fork.
+2. Explain the problem and the proposed change.
+3. Include or update tests when appropriate.
+4. Run the relevant checks locally.
+5. Open a pull request against the default branch.
+
+All pull requests are subject to review by TokenAI. Opening a pull request
+does not guarantee acceptance or merge. TokenAI may accept, request changes,
+reject, close, or remove a proposed contribution at its sole discretion.
+
+## Contribution terms
+
+By submitting a pull request, patch, issue attachment, or other contribution to
+this repository, you confirm that you have read and agree to the
+[TokenAI Contributor License Agreement](TOKENAI_CLA.md), and that:
+
+- you have the legal right to submit the contribution;
+- the contribution is your original work or you have permission to submit it;
+- you have identified any third-party code, data, or assets included in it;
+- you have not knowingly included secrets, credentials, or private data; and
+- you agree to the copyright assignment and license grant in
+  [TOKENAI_CLA.md](TOKENAI_CLA.md).
+
+## Attribution
+
+Contributions become part of a project owned and maintained by TokenAI. Do not
+remove existing NeuralNode or TokenAI notices. Derivative products and forks
+must continue to follow [LICENSE](LICENSE) and [TRADEMARKS.md](TRADEMARKS.md).
+
+## Code of conduct
+
+Be respectful, constructive, and specific. Harassment, discrimination,
+deliberate disclosure of secrets, and malicious code are not acceptable.

neuralnode-2.2.9/LICENSE

@@ -0,0 +1,157 @@
+TokenAI Source-Available License
+Version 1.0
+
+Copyright (c) 2024–2026 TokenAI. All rights reserved.
+
+IMPORTANT NOTICE
+
+This is a source-available license. It is not an OSI-approved Open Source
+license. The NeuralNode Framework and the original NeuralNode source code are
+owned by TokenAI, subject to the rights of third-party components identified in
+THIRD_PARTY_NOTICES.md and their respective licenses.
+
+1. Definitions
+
+"Licensor" means TokenAI, the owner of the NeuralNode Framework.
+
+"NeuralNode" or "Software" means the original source code, documentation,
+configuration, and other materials in this repository that are identified as
+part of the NeuralNode Framework and owned by TokenAI.
+
+"Derivative Work" means a work based on, incorporating, or substantially
+modifying the Software, including a fork or a product that incorporates the
+core NeuralNode runtime or architecture.
+
+"Competing Framework" means a generally available software framework, runtime,
+platform, SDK, or service whose primary purpose is substantially similar to
+the primary purpose of NeuralNode, including the orchestration of AI models,
+provider abstraction, agents, tools, memory, RAG, or materially similar
+capabilities, where NeuralNode or a substantial portion of its code or
+architecture is used as a material part of that offering.
+
+2. Limited License Grant
+
+Subject to this License, TokenAI grants you a worldwide, non-exclusive,
+non-transferable, royalty-free license to:
+
+  a. view and study the Software;
+  b. use the Software for personal, educational, research, and internal
+     business purposes;
+  c. modify the Software for those purposes; and
+  d. create and distribute applications that use the Software, provided that
+     the application is not a Competing Framework and all requirements of this
+     License are satisfied.
+
+This license does not transfer ownership of the Software or any intellectual
+property rights in NeuralNode to you.
+
+3. Attribution and Source Notice
+
+If you use, modify, fork, embed, or distribute the Software or a Derivative
+Work, you must clearly and prominently acknowledge NeuralNode and its source
+repository in:
+
+  a. the source distribution and its documentation;
+  b. a credits, licenses, about, or acknowledgements page in the product; and
+  c. the product's administrator-facing documentation or settings page when
+     the product has such a page.
+
+The acknowledgement must include substantially the following statement:
+
+  "This product uses NeuralNode, a framework owned by TokenAI."
+  "Source: https://github.com/tokenaillc/neuralnode"
+
+You must retain this License, existing copyright notices, and all attribution
+notices. You must not remove or obscure the NeuralNode or TokenAI notices.
+
+4. Restrictions
+
+You may not:
+
+  a. create, distribute, host, sell, license, or operate a Competing
+     Framework based on or incorporating the Software;
+  b. offer the Software itself, or a substantially unmodified version of it,
+     as a standalone commercial product or hosted service;
+  c. remove, alter, or obscure required attribution, copyright, or license
+     notices;
+  d. use the names, logos, or trademarks "NeuralNode" or "TokenAI" in a way
+     that implies endorsement, sponsorship, partnership, or official status;
+  e. represent that a fork or Derivative Work is the official NeuralNode
+     project; or
+  f. sublicense or relicense the Software under terms that conflict with this
+     License.
+
+This License does not prevent you from building an application that uses
+NeuralNode as a component, provided that the application is not a Competing
+Framework and the attribution requirements are met.
+
+5. Contributions and Pull Requests
+
+TokenAI welcomes bug fixes, documentation improvements, tests, and other
+proposals submitted through GitHub issues, forks, or pull requests. A pull
+request is a proposal only; it does not become part of NeuralNode unless and
+until TokenAI accepts and merges it.
+
+By intentionally submitting a contribution for inclusion in NeuralNode, you
+agree that TokenAI may review, modify, combine, license, distribute, and
+relicense the contribution as part of NeuralNode under this License or under a
+separate commercial or successor license. You represent that you have the
+right to submit the contribution and that it does not knowingly violate a
+third party's rights.
+
+Submission of a pull request does not give the contributor commit, merge,
+release, or administrative access. TokenAI retains sole discretion to accept,
+request changes to, reject, close, or remove any contribution.
+
+Contributors must follow CONTRIBUTING.md and any contribution agreement or
+Developer Certificate of Origin required by the repository at the time of
+submission.
+
+6. Commercial License
+
+TokenAI may grant separate commercial licenses, waivers, or written
+permissions for uses restricted by this License. A commercial license may
+permit use in a Competing Framework, removal or relocation of attribution,
+white-label distribution, or other uses not permitted here. No commercial
+permission is granted unless it is signed or expressly issued in writing by
+TokenAI.
+
+7. Third-Party Materials
+
+This License applies only to material owned by TokenAI. Third-party libraries,
+models, model weights, APIs, datasets, fonts, images, and other materials are
+not relicensed by this document and remain subject to their own licenses and
+terms. See THIRD_PARTY_NOTICES.md and MODEL_LICENSES.md when present.
+
+8. Trademarks
+
+This License does not grant permission to use TokenAI or NeuralNode trademarks,
+logos, or brand assets except for the attribution required by Section 3 and
+ordinary factual reference to the Software. Additional use is governed by
+TRADEMARKS.md or requires written permission from TokenAI.
+
+9. Termination
+
+The rights granted by this License terminate automatically if you materially
+breach this License. Rights may be reinstated if TokenAI gives you written
+permission or if the breach is cured within thirty (30) days after written
+notice, where cure is possible.
+
+10. Disclaimer and Limitation of Liability
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, EXPRESS OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR
+A PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT. TO THE MAXIMUM EXTENT
+PERMITTED BY LAW, TOKENAI AND ITS CONTRIBUTORS SHALL NOT BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ARISING FROM THE SOFTWARE OR THIS LICENSE.
+
+11. Governing Terms
+
+This License is intended to be interpreted under the laws applicable to TokenAI
+and the jurisdiction specified in any executed commercial agreement. If any
+provision is held unenforceable, the remaining provisions remain in effect.
+
+This License is a draft public distribution license for NeuralNode Source-
+Available License Version 1.0 and should be reviewed by qualified legal counsel
+before the repository is made public.

neuralnode-2.2.9/NOTICE

@@ -0,0 +1,15 @@
+NeuralNode Framework
+
+Copyright (c) 2024–2026 TokenAI. All rights reserved.
+
+NeuralNode and TokenAI are trademarks and proprietary intellectual property of
+TokenAI. Use of the source code is governed by the NeuralNode Source-Available
+License Version 1.0 in the LICENSE file.
+
+Required attribution for products using NeuralNode:
+
+"This product uses NeuralNode, a framework owned by TokenAI."
+"Source: https://github.com/tokenaillc/neuralnode"
+
+Third-party components are governed by their own licenses. They are not
+relicensed by this NOTICE or by the NeuralNode license.