Metadata-Version: 2.5
Name: neuralnode
Version: 2.2.10
Summary: Connect models. Build AI. A Python framework for LLM providers, agents, memory, RAG, and tools.
Project-URL: Homepage, https://tokenai.llc/
Project-URL: NeuralNode, https://tokenai.llc/
Project-URL: Documentation, https://neuralnode.readthedocs.io
Project-URL: Repository, https://github.com/tokenaillc/neuralnode
Project-URL: Issues, https://github.com/tokenaillc/neuralnode/issues
Project-URL: Changelog, https://github.com/tokenaillc/neuralnode/blob/main/CHANGELOG.md
Author-email: Assem Sabry <assemsabry777@gmail.com>
Maintainer-email: Assem Sabry <assemsabry777@gmail.com>
License: 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.
License-File: LICENSE
License-File: NOTICE
Keywords: agent,ai,anthropic,automation,embeddings,framework,google,langchain,llm,ollama,openai,rag,tools,vector-stores
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: numpy>=1.24.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: requests>=2.28.0
Provides-Extra: all
Requires-Dist: accelerate>=0.24.0; extra == 'all'
Requires-Dist: anthropic>=0.8.0; extra == 'all'
Requires-Dist: beautifulsoup4>=4.12.0; extra == 'all'
Requires-Dist: bitsandbytes>=0.41.0; extra == 'all'
Requires-Dist: chromadb>=0.4.0; extra == 'all'
Requires-Dist: cohere>=4.0.0; extra == 'all'
Requires-Dist: edge-tts>=6.1.0; extra == 'all'
Requires-Dist: einops>=0.7.0; extra == 'all'
Requires-Dist: faiss-cpu>=1.7.4; extra == 'all'
Requires-Dist: fastapi>=0.110.0; extra == 'all'
Requires-Dist: gguf; extra == 'all'
Requires-Dist: google-generativeai>=0.3.0; extra == 'all'
Requires-Dist: groq>=0.4.0; extra == 'all'
Requires-Dist: huggingface-hub>=0.23.0; extra == 'all'
Requires-Dist: llama-cpp-python>=0.2.0; extra == 'all'
Requires-Dist: mistralai>=0.0.12; extra == 'all'
Requires-Dist: ollama>=0.1.0; extra == 'all'
Requires-Dist: openai>=1.0.0; extra == 'all'
Requires-Dist: protobuf>=3.20.0; extra == 'all'
Requires-Dist: psutil>=5.9.0; extra == 'all'
Requires-Dist: pydub>=0.25.1; extra == 'all'
Requires-Dist: pypdf>=3.17.0; extra == 'all'
Requires-Dist: python-docx>=0.8.11; extra == 'all'
Requires-Dist: python-telegram-bot>=20.0; extra == 'all'
Requires-Dist: scipy>=1.10.0; extra == 'all'
Requires-Dist: sentence-transformers>=2.2.0; extra == 'all'
Requires-Dist: sentencepiece>=0.1.99; extra == 'all'
Requires-Dist: speechrecognition>=3.10.0; extra == 'all'
Requires-Dist: sqlalchemy>=2.0.0; extra == 'all'
Requires-Dist: torch>=2.0.0; extra == 'all'
Requires-Dist: transformers>=4.35.0; extra == 'all'
Requires-Dist: uvicorn>=0.27.0; extra == 'all'
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.8.0; extra == 'anthropic'
Provides-Extra: aws
Requires-Dist: boto3>=1.34.0; extra == 'aws'
Provides-Extra: azure
Requires-Dist: openai>=1.0.0; extra == 'azure'
Provides-Extra: chroma
Requires-Dist: chromadb>=0.4.0; extra == 'chroma'
Provides-Extra: cohere
Requires-Dist: cohere>=4.0.0; extra == 'cohere'
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: fastapi>=0.110.0; extra == 'dev'
Requires-Dist: mypy>=1.7.0; extra == 'dev'
Requires-Dist: pillow>=10.0.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Requires-Dist: uvicorn>=0.27.0; extra == 'dev'
Provides-Extra: discord
Requires-Dist: discord-py>=2.3.0; extra == 'discord'
Provides-Extra: embeddings
Requires-Dist: fastembed>=0.1.0; extra == 'embeddings'
Requires-Dist: instructorembedding>=1.0.1; extra == 'embeddings'
Requires-Dist: sentence-transformers>=2.2.0; extra == 'embeddings'
Requires-Dist: tiktoken>=0.5.0; extra == 'embeddings'
Provides-Extra: faiss
Requires-Dist: faiss-cpu>=1.7.4; extra == 'faiss'
Provides-Extra: flash-attn
Requires-Dist: flash-attn>=2.3.0; extra == 'flash-attn'
Provides-Extra: google
Requires-Dist: google-cloud-aiplatform>=1.38.0; extra == 'google'
Requires-Dist: google-generativeai>=0.3.0; extra == 'google'
Provides-Extra: groq
Requires-Dist: groq>=0.4.0; extra == 'groq'
Provides-Extra: hf-audio
Requires-Dist: scipy>=1.11.0; extra == 'hf-audio'
Requires-Dist: soundfile>=0.12.0; extra == 'hf-audio'
Requires-Dist: torch>=2.0.0; extra == 'hf-audio'
Requires-Dist: transformers>=4.35.0; extra == 'hf-audio'
Provides-Extra: horus
Requires-Dist: accelerate>=0.24.0; extra == 'horus'
Requires-Dist: bitsandbytes>=0.41.0; extra == 'horus'
Requires-Dist: diffusers>=0.30.0; extra == 'horus'
Requires-Dist: einops>=0.7.0; extra == 'horus'
Requires-Dist: gguf; extra == 'horus'
Requires-Dist: huggingface-hub>=0.23.0; extra == 'horus'
Requires-Dist: llama-cpp-python>=0.2.0; extra == 'horus'
Requires-Dist: pillow>=10.0.0; extra == 'horus'
Requires-Dist: protobuf>=3.20.0; extra == 'horus'
Requires-Dist: scipy>=1.10.0; extra == 'horus'
Requires-Dist: sentencepiece>=0.1.99; extra == 'horus'
Requires-Dist: torch>=2.0.0; extra == 'horus'
Requires-Dist: transformers>=4.35.0; extra == 'horus'
Provides-Extra: image
Requires-Dist: accelerate>=0.24.0; extra == 'image'
Requires-Dist: diffusers>=0.30.0; extra == 'image'
Requires-Dist: pillow>=10.0.0; extra == 'image'
Requires-Dist: torch>=2.0.0; extra == 'image'
Requires-Dist: transformers>=4.35.0; extra == 'image'
Provides-Extra: local
Requires-Dist: accelerate>=0.24.0; extra == 'local'
Requires-Dist: gguf; extra == 'local'
Requires-Dist: huggingface-hub>=0.23.0; extra == 'local'
Requires-Dist: llama-cpp-python>=0.2.0; extra == 'local'
Requires-Dist: protobuf>=3.20.0; extra == 'local'
Requires-Dist: sentencepiece>=0.1.99; extra == 'local'
Requires-Dist: torch>=2.0.0; extra == 'local'
Requires-Dist: transformers>=4.35.0; extra == 'local'
Provides-Extra: local-all
Requires-Dist: accelerate>=0.24.0; extra == 'local-all'
Requires-Dist: bitsandbytes>=0.41.0; extra == 'local-all'
Requires-Dist: einops>=0.7.0; extra == 'local-all'
Requires-Dist: gguf; extra == 'local-all'
Requires-Dist: huggingface-hub>=0.23.0; extra == 'local-all'
Requires-Dist: llama-cpp-python>=0.2.0; extra == 'local-all'
Requires-Dist: protobuf>=3.20.0; extra == 'local-all'
Requires-Dist: scipy>=1.10.0; extra == 'local-all'
Requires-Dist: sentencepiece>=0.1.99; extra == 'local-all'
Requires-Dist: torch>=2.0.0; extra == 'local-all'
Requires-Dist: transformers>=4.35.0; extra == 'local-all'
Provides-Extra: milvus
Requires-Dist: pymilvus>=2.3.0; extra == 'milvus'
Provides-Extra: mistral
Requires-Dist: mistralai>=0.0.12; extra == 'mistral'
Provides-Extra: ollama
Requires-Dist: ollama>=0.1.0; extra == 'ollama'
Provides-Extra: openai
Requires-Dist: openai>=1.0.0; extra == 'openai'
Provides-Extra: openclaw
Requires-Dist: fastapi>=0.110.0; extra == 'openclaw'
Requires-Dist: uvicorn>=0.27.0; extra == 'openclaw'
Provides-Extra: pinecone
Requires-Dist: pinecone-client>=2.2.0; extra == 'pinecone'
Provides-Extra: qdrant
Requires-Dist: qdrant-client>=1.6.0; extra == 'qdrant'
Provides-Extra: rag
Requires-Dist: beautifulsoup4>=4.12.0; extra == 'rag'
Requires-Dist: markdown>=3.5.0; extra == 'rag'
Requires-Dist: openpyxl>=3.1.0; extra == 'rag'
Requires-Dist: pypdf>=3.17.0; extra == 'rag'
Requires-Dist: python-docx>=0.8.11; extra == 'rag'
Provides-Extra: redis
Requires-Dist: redis>=5.0.0; extra == 'redis'
Provides-Extra: replica
Requires-Dist: edge-tts>=6.1.0; extra == 'replica'
Provides-Extra: slack
Requires-Dist: slack-sdk>=3.21.0; extra == 'slack'
Provides-Extra: speech
Requires-Dist: pydub>=0.25.1; extra == 'speech'
Requires-Dist: speechrecognition>=3.10.0; extra == 'speech'
Provides-Extra: telegram
Requires-Dist: edge-tts>=6.1.0; extra == 'telegram'
Requires-Dist: pydub>=0.25.1; extra == 'telegram'
Requires-Dist: pypdf>=3.17.0; extra == 'telegram'
Requires-Dist: python-docx>=0.8.11; extra == 'telegram'
Requires-Dist: python-telegram-bot>=20.0; extra == 'telegram'
Requires-Dist: speechrecognition>=3.10.0; extra == 'telegram'
Provides-Extra: tools
Requires-Dist: psutil>=5.9.0; extra == 'tools'
Requires-Dist: pymongo>=4.6.0; extra == 'tools'
Requires-Dist: serpapi>=0.1.0; extra == 'tools'
Requires-Dist: sqlalchemy>=2.0.0; extra == 'tools'
Requires-Dist: wikipedia>=1.4.0; extra == 'tools'
Provides-Extra: turboquant
Provides-Extra: vision
Requires-Dist: pillow>=9.0; extra == 'vision'
Provides-Extra: weaviate
Requires-Dist: weaviate-client>=3.0.0; extra == 'weaviate'
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/tokenaillc/neuralnode/main/media/neuralnode-dark-transparent.png" alt="NeuralNode" width="720">
</p>

# NeuralNode

**NeuralNode 2.2.10** is a Python framework for connecting cloud and local AI models through one provider interface. It includes chat, streaming, vision, embeddings, agents, memory, RAG, speech, Hugging Face models, Horus models, Ollama, OpenClaw, and optional integrations.

NeuralNode is developed and fully owned by **TokenAI**. It is distributed under the TokenAI Source-Available License described at the end of this file.

## Install

```bash
pip install neuralnode
```

Install only the feature set you need:

```bash
pip install "neuralnode[ollama]"      # Ollama client support
pip install "neuralnode[local]"       # local Transformers/GGUF models
pip install "neuralnode[horus]"       # Horus local models
pip install "neuralnode[replica]"     # Replica TTS adapter
pip install "neuralnode[telegram]"    # Telegram integration
pip install "neuralnode[openclaw]"    # OpenClaw gateway integration
pip install "neuralnode[all]"         # all published optional features
```

The base package stays lightweight. Large ML runtimes, vector stores, speech libraries, and provider SDKs are optional.

## Quick start

```python
import neuralnode as nn

ai = nn.NeuralNode(provider="groq", model="llama-3.1-8b-instant")
print(ai.chat("Explain embeddings in one paragraph."))
```

Set the provider API key before running:

```powershell
$env:GROQ_API_KEY="your-key"
```

## Why use NeuralNode?

NeuralNode helps developers build model-powered applications through one
consistent Python interface for providers, local runtimes, agents, tools,
embeddings, and retrieval workflows.

- **Model interoperability** — Move between cloud APIs, Ollama, Transformers,
  llama.cpp, vLLM, Horus, and other supported runtimes without rewriting the
  application layer.
- **Rapid prototyping** — Start with a small chat call, then add streaming,
  vision, tools, memory, RAG, or speech as the application grows.
- **Local and private execution** — Run compatible models locally through
  Ollama and other local backends when data-control or offline workflows matter.
- **Production building blocks** — Use normalized provider responses, agents,
  tool calling, embeddings, vector stores, OpenClaw, and optional integrations.
- **Provider flexibility** — Inspect the installed registry and switch models
  or providers through configuration instead of coupling business logic to one
  vendor.
- **Optional by design** — Keep the base install lightweight and add only the
  SDKs and heavy runtimes needed by the project.

## Do this → run this

### See supported providers

```python
import neuralnode as nn

print(nn.get_available_providers())
print(nn.get_provider_info("ollama"))
```

The registry is the source of truth for the installed package. Optional provider SDKs may still be required when creating a provider.

### List the built-in model catalog

```python
import neuralnode as nn

for model_id, info in nn.list_models().items():
    print(model_id, info)
```

### Chat with a local Ollama model

Start Ollama and pull a model:

```bash
ollama serve
ollama pull qwen3
```

Then:

```python
import neuralnode as nn

ai = nn.NeuralNode(provider="ollama", model="qwen3")
print(ai.chat("Give me three names for a robotics project."))
```

For a remote/containerized Ollama server:

```python
ai = nn.NeuralNode(
    provider="ollama",
    model="qwen3",
    base_url="http://127.0.0.1:11434",
)
```

### Enable or disable local-model reasoning

For Ollama, `thinking` maps to its native `think` field. `None` keeps the model default, `True` enables reasoning, and `False` disables it:

```python
import neuralnode as nn

ai = nn.NeuralNode(provider="ollama", model="qwen3")
print(ai.chat("What is 2 + 2?", thinking=False))
print(ai.chat("Compare two sorting algorithms.", thinking=True))
```

To access the normalized reasoning trace itself:

```python
from neuralnode.providers.local_providers import OllamaProvider

ollama = OllamaProvider(model="qwen3")
response = ollama.chat(
    [{"role": "user", "content": "Explain binary search."}],
    thinking=True,
)
print(response["content"])
print(response["thinking"])
```

Reasoning is model-dependent; a model without native reasoning may return an empty `thinking` field.

### Stream a response

```python
for chunk in ai.chat("Write a short poem about Cairo.", stream=True):
    print(chunk, end="", flush=True)
```

### Send an image to a vision-capable model

```python
ai = nn.NeuralNode(provider="ollama", model="llava")
print(ai.chat_with_image("Describe this image.", image="photo.jpg"))
```

### Create an agent with tools and reasoning

```python
ai = nn.NeuralNode(provider="ollama", model="qwen3")
agent = ai.agent(
    skills=["datetime", "calculator"],
    thinking=True,
    max_iterations=10,
)
print(agent.run("What time is it, and what is 37 * 19?"))
```

Supported skill names include `web_search`, `datetime`, `system_control`, `file`, `python`, `calculator`, and `all`. Use `thinking=False` to execute without the reasoning wrapper.

### Add conversation memory

```python
ai = nn.NeuralNode(provider="ollama", model="qwen3").with_memory()
ai.chat("My project is called Atlas.")
print(ai.chat_with_memory("What is my project called?"))
```

### Generate embeddings

```python
ai = nn.NeuralNode(provider="ollama", model="nomic-embed-text")
vectors = ai.embed(["NeuralNode connects models.", "Ollama runs locally."])
print(len(vectors), len(vectors[0]))
```

### Build a small RAG system

```python
ai = nn.NeuralNode(provider="ollama", model="qwen3")
rag = ai.rag(store="memory", top_k=3)
rag.add_documents(["NeuralNode is owned by TokenAI.", "Ollama is a local runtime."])
print(rag.query("Who owns NeuralNode?"))
```

For persistent Chroma storage:

```bash
pip install "neuralnode[chroma]"
```

```python
rag = ai.rag(store="chroma", persist_dir="./neuralnode-db")
```

### Download or load a Hugging Face model

```python
from neuralnode import download_repo, load_hf_model

path = download_repo("sentence-transformers/all-MiniLM-L6-v2")
model = load_hf_model("sentence-transformers/all-MiniLM-L6-v2")
print(path, model)
```

Private or gated repositories require `HF_TOKEN` or an explicit token. Heavy dependencies are installed with the `local` extra.

### Use Horus models

```bash
pip install "neuralnode[horus]"
```

```python
from neuralnode import HorusModel

model = HorusModel(model_id="TokenAI/your-horus-model")
print(model.chat("Hello from a local Horus model."))
```

### Generate speech with Replica

```bash
pip install "neuralnode[replica]"
```

```python
from neuralnode import ReplicaTTS

tts = ReplicaTTS(voice_id="default")
tts.speak("Welcome to NeuralNode.", output_file="welcome.mp3")
```

### Run Telegram

```bash
pip install "neuralnode[telegram]"
```

```python
from neuralnode import NeuralNode
from neuralnode.integrations.telegram import TelegramBot

ai = NeuralNode(provider="ollama", model="qwen3")
bot = TelegramBot(token="your-token", agent=ai.agent())
bot.run()
```

### Connect NeuralNode to OpenClaw

```bash
pip install "neuralnode[openclaw]"
```

```python
from neuralnode import NeuralNode
from neuralnode.integrations.openclaw import OpenClawServer

ai = NeuralNode(provider="ollama", model="qwen3")
server = OpenClawServer(node=ai, host="127.0.0.1", port=8001, api_key="change-me")
server.run()
```

Keep the gateway on loopback unless a deliberate network and authentication configuration protects it. Do not expose a development gateway publicly without authentication and a reverse proxy policy.

## Provider surface

The registry includes cloud adapters such as OpenAI-compatible, Anthropic, Google, Groq, Cohere, Mistral, DeepSeek, Perplexity, Together, Fireworks, Bedrock, and Vertex AI, plus local adapters including Ollama, llama.cpp, Transformers, vLLM, TGI, MLX, Horus, and other compatible runtimes.

Print the exact installed registry:

```python
import neuralnode as nn
print("\\n".join(nn.get_available_providers()))
```

Provider SDKs and credentials are optional. A provider in the registry does not mean its external service or model is included in this package.

## Resources

- [Detailed documentation](docs/documentation.md) — API concepts and guides.
- [Changelog](CHANGELOG.md) — shipped changes and release history.
- [Contributing guide](CONTRIBUTING.md) — development and contribution workflow.
- [License](LICENSE) — TokenAI Source-Available License v1.0.
- [Security policy](https://github.com/tokenaillc/neuralnode/security) — report
  security issues responsibly.
- [PyPI package](https://pypi.org/project/neuralnode/) — installation and
  published distributions.
- [GitHub releases](https://github.com/tokenaillc/neuralnode/releases) — release
  notes and source snapshots.

## What's new in 2.2.9

- Removed the deprecated WhatsApp/Twilio integration and legacy gateway.
- Improved OpenClaw configuration, loopback binding, token authentication, OpenAI-compatible chat-completions support, and streaming fallback.
- Upgraded Ollama to native `/api/chat` with role-preserving messages, streaming, structured output, tool calls, and native reasoning control through `thinking=True` or `thinking=False`.
- Updated Ollama embeddings to batch `/api/embed` with a legacy compatibility fallback.
- Added and validated the NeuralNode → OpenClaw → local model path on AWS.
- Retained Hugging Face speech, vision, Horus, Replica, agents, memory, RAG, vector-store, and optional TurboQuant workflows.
- Added reproducible wheel/source builds, CI validation for Python 3.9–3.12, and trusted PyPI publishing through GitHub Actions.

See [CHANGELOG.md](CHANGELOG.md) for the complete release history.

## Coming soon to NeuralNode

- `replica-preview-0.6B` — TTS model.
- `horus-cyber-nano-1.2` — text model with vision capabilities.

These are announced as coming soon and are not shipped weights in NeuralNode 2.2.9.

## Support and security

For bugs, include the Python version, NeuralNode version, provider, model, a minimal reproduction, and the full error message with secrets removed. Never commit API keys, Hugging Face tokens, Telegram tokens, or OpenClaw authentication tokens.

## Ownership and license

NeuralNode, its source code, documentation, branding, release artifacts, and maintained integrations are the **exclusive property of TokenAI**. Nothing in this repository transfers ownership or permits redistribution, rebranding, sale, sublicensing, or offering NeuralNode as a competing hosted service without written authorization from TokenAI.

NeuralNode is released under the **TokenAI Source-Available License v1.0** in [LICENSE](LICENSE). This is a proprietary source-available license, not an OSI-approved open-source license. Third-party providers, SDKs, model weights, and external services remain subject to their own licenses and terms.

