neuralnode 2.2.7__tar.gz → 2.2.8__tar.gz

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

@@ -1,26 +1,35 @@
-# 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
+
+# Horus Cyber Nano 1.0 BETA Early Access
+HORUS_CYBER_NANO_API_KEY=horusNN-your-access-token
+HORUS_CYBER_NANO_BASE_URL=https://api.tokenai.llc/v1
+
+# NeuralNode H-Preview API Gateway
+NEURALNODE_API_DB=neuralnode-api.sqlite3
+NEURALNODE_API_KEY=nn-your-24-character-token
+NEURALNODE_API_BASE_URL=http://127.0.0.1:8000/v1
+H_PREVIEW_UPSTREAM_URL=http://127.0.0.1:8001/v1
+H_PREVIEW_UPSTREAM_MODEL=DavidAU/Qwen3.8-27B-TURBO-Fable-Cold-Fusion-735-882-Heretic-Uncensored-NM-DAU
+# Optional: only set this when the remote model server requires an API key.
+# H_PREVIEW_UPSTREAM_API_KEY=
+
+# NeuralNode Settings
+NEURALNODE_DEFAULT_PROVIDER=auto
+NEURALNODE_MEMORY_ENABLED=true
+NEURALNODE_SAFE_MODE=true
+NEURALNODE_LOG_LEVEL=INFO

neuralnode-2.2.8/.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.8/.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.8/.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.8'; 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.8/.gitignore

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

neuralnode-2.2.8/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.7 → neuralnode-2.2.8}/Dockerfile

@@ -1,44 +1,44 @@
-FROM python:3.11-slim
-
-# Set environment variables
-ENV PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONUNBUFFERED=1 \
-    PIP_NO_CACHE_DIR=1 \
-    PIP_DISABLE_PIP_VERSION_CHECK=1
-
-# Install system dependencies
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    build-essential \
-    curl \
-    git \
-    && rm -rf /var/lib/apt/lists/*
-
-# Set work directory
-WORKDIR /app
-
-# Install Python dependencies
-COPY pyproject.toml README.md ./
-RUN pip install --upgrade pip && \
-    pip install -e ".[all]" --no-cache-dir
-
-# Copy application code
-COPY src/ ./src/
-COPY examples/ ./examples/
-
-# Install the package
-RUN pip install -e .
-
-# Create non-root user
-RUN useradd -m -u 1000 neuralnode && \
-    chown -R neuralnode:neuralnode /app
-USER neuralnode
-
-# Expose port for API (if needed)
-EXPOSE 8000
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
-    CMD python -c "import neuralnode; print('OK')" || exit 1
-
-# Default command
-CMD ["python", "-c", "import neuralnode; print('NeuralNode v' + neuralnode.__version__ + ' ready')"]
+FROM python:3.11-slim
+
+# Set environment variables
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    curl \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set work directory
+WORKDIR /app
+
+# Install Python dependencies
+COPY pyproject.toml README.md ./
+RUN pip install --upgrade pip && \
+    pip install -e ".[all]" --no-cache-dir
+
+# Copy application code
+COPY src/ ./src/
+COPY examples/ ./examples/
+
+# Install the package
+RUN pip install -e .
+
+# Create non-root user
+RUN useradd -m -u 1000 neuralnode && \
+    chown -R neuralnode:neuralnode /app
+USER neuralnode
+
+# Expose port for API (if needed)
+EXPOSE 8000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD python -c "import neuralnode; print('OK')" || exit 1
+
+# Default command
+CMD ["python", "-c", "import neuralnode; print('NeuralNode v' + neuralnode.__version__ + ' ready')"]

neuralnode-2.2.8/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.8/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.