hypnex-openai 0.1.0__tar.gz

hypnex_openai-0.1.0/.gitignore

@@ -0,0 +1,66 @@
+# --- Python ---
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+build/
+dist/
+.eggs/
+.pytest_cache/
+.ruff_cache/
+.tox/
+.coverage
+.coverage.*
+htmlcov/
+.venv/
+venv/
+env/
+
+# --- Node / TypeScript ---
+node_modules/
+*.tsbuildinfo
+.npm/
+.yarn/
+.pnpm-store/
+.parcel-cache/
+
+# --- Next.js (apps/stake) ---
+.next/
+out/
+.vercel/
+
+# --- Wrangler / Cloudflare ---
+.wrangler/
+
+# --- Foundry (registry-contracts) ---
+forge-cache/
+broadcast/
+
+# --- Editor / OS ---
+.idea/
+.vscode/
+.DS_Store
+*.swp
+*.swo
+*~
+
+# --- Local secrets — never commit ---
+.env
+.env.*
+!.env.example
+.env.local
+.env.production
+
+# --- Log + tmp ---
+*.log
+logs/
+tmp/
+
+# --- Build outputs in apps/bench ---
+apps/bench/out/
+
+# --- Generated bench data is committed (audit trail) but local runs aren't ---
+python-bench/data/*.jsonl
+
+# Claude Code session artifacts — never commit
+.claude/

hypnex_openai-0.1.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: hypnex-openai
+Version: 0.1.0
+Summary: Drop-in OpenAI client for the Morpheus decentralized inference network (mor.org)
+Project-URL: Homepage, https://hypnex.xyz
+Project-URL: Documentation, https://docs.hypnex.xyz
+Project-URL: Repository, https://github.com/hypnex-labs/hypnex
+Project-URL: Issues, https://github.com/hypnex-labs/hypnex/issues
+Author: Hypnex Labs
+License: MIT
+Keywords: agents,ai,crypto,decentralized,llm,morpheus,openai
+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.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
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: openai<2.0.0,>=1.50.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# hypnex-openai (Python)
+
+Drop-in OpenAI client for the Morpheus decentralized inference network ([mor.org](https://mor.org)).
+
+```bash
+pip install hypnex-openai
+```
+
+```python
+from hypnex_openai import HypnexOpenAI
+
+client = HypnexOpenAI(api_key="mor_...")  # get one at https://app.mor.org
+
+response = client.chat.completions.create(
+    model="mistral-31-24b",
+    messages=[{"role": "user", "content": "Hello"}],
+)
+print(response.choices[0].message.content)
+```
+
+`HypnexOpenAI` subclasses `openai.OpenAI` and points it at `https://api.mor.org/api/v1`. Streaming, tools, async, structured output — all work unchanged.
+
+## Models on the Morpheus network
+
+The network exposes 60+ models via OpenAI-compatible endpoints. List them:
+
+```bash
+hypnex models
+```
+
+Or programmatically:
+
+```python
+client.morpheus.active_models()           # full registry
+client.morpheus.models_by_type("LLM")     # filter
+client.morpheus.find_model("glm-5")       # lookup
+```
+
+Featured LLMs: `mistral-31-24b`, `glm-5`, `qwen3-235b`, `qwen3-coder-480b-a35b-instruct`, `deepseek-r1:70b`, `minimax-m25`. Embeddings: `text-embedding-bge-m3`. TTS: `tts-kokoro`. STT: `whisper-1`.
+
+## Drop-in for popular frameworks
+
+Any framework that accepts a `base_url` accepts Morpheus:
+
+```python
+# LangChain
+from langchain_openai import ChatOpenAI
+llm = ChatOpenAI(
+    model="qwen3-235b",
+    api_key=os.environ["HYPNEX_API_KEY"],
+    base_url="https://api.mor.org/api/v1",
+)
+
+# CrewAI
+from crewai import LLM
+llm = LLM(
+    model="openai/qwen3-235b",
+    api_key=os.environ["HYPNEX_API_KEY"],
+    base_url="https://api.mor.org/api/v1",
+)
+
+# llama-index
+from llama_index.llms.openai_like import OpenAILike
+llm = OpenAILike(
+    model="qwen3-235b",
+    api_base="https://api.mor.org/api/v1",
+    api_key=os.environ["HYPNEX_API_KEY"],
+    is_chat_model=True,
+)
+
+# instructor
+import instructor
+client = instructor.from_openai(HypnexOpenAI())
+```
+
+## Morpheus-specific endpoints
+
+`client.morpheus.*` exposes endpoints that have no OpenAI equivalent:
+
+| Method | What it does |
+|---|---|
+| `balance()` | Current MOR balance |
+| `transactions(limit=50)` | Billing history |
+| `spending()` | Cumulative usage |
+| `me()` | User profile |
+| `list_keys()` / `create_key(name)` / `delete_key(id)` / `set_default_key(id)` | API keys |
+| `link_wallet(addr, sig, msg)` / `get_wallet()` / `unlink_wallet()` | Wallet binding |
+| `active_models()` / `find_model(name)` / `models_by_type(type)` | Public registry |
+
+## CLI
+
+```bash
+hypnex models                          # list
+hypnex health                          # show api.mor.org health
+hypnex chat "Hello" --model glm-5      # one-shot
+```
+
+## Async
+
+```python
+from hypnex_openai import AsyncHypnexOpenAI
+client = AsyncHypnexOpenAI(api_key="mor_...")
+r = await client.chat.completions.create(...)
+```
+
+## Environment
+
+- `HYPNEX_API_KEY` — your API key (required)
+- `HYPNEX_BASE_URL` — override base URL (default `https://api.mor.org/api/v1`)
+
+## Tests
+
+```bash
+pip install -e ".[dev]"
+pytest                                   # public smoke tests
+HYPNEX_API_KEY=mor_... pytest          # also run authenticated tests
+```
+
+## License
+
+MIT

hypnex_openai-0.1.0/README.md

@@ -0,0 +1,121 @@
+# hypnex-openai (Python)
+
+Drop-in OpenAI client for the Morpheus decentralized inference network ([mor.org](https://mor.org)).
+
+```bash
+pip install hypnex-openai
+```
+
+```python
+from hypnex_openai import HypnexOpenAI
+
+client = HypnexOpenAI(api_key="mor_...")  # get one at https://app.mor.org
+
+response = client.chat.completions.create(
+    model="mistral-31-24b",
+    messages=[{"role": "user", "content": "Hello"}],
+)
+print(response.choices[0].message.content)
+```
+
+`HypnexOpenAI` subclasses `openai.OpenAI` and points it at `https://api.mor.org/api/v1`. Streaming, tools, async, structured output — all work unchanged.
+
+## Models on the Morpheus network
+
+The network exposes 60+ models via OpenAI-compatible endpoints. List them:
+
+```bash
+hypnex models
+```
+
+Or programmatically:
+
+```python
+client.morpheus.active_models()           # full registry
+client.morpheus.models_by_type("LLM")     # filter
+client.morpheus.find_model("glm-5")       # lookup
+```
+
+Featured LLMs: `mistral-31-24b`, `glm-5`, `qwen3-235b`, `qwen3-coder-480b-a35b-instruct`, `deepseek-r1:70b`, `minimax-m25`. Embeddings: `text-embedding-bge-m3`. TTS: `tts-kokoro`. STT: `whisper-1`.
+
+## Drop-in for popular frameworks
+
+Any framework that accepts a `base_url` accepts Morpheus:
+
+```python
+# LangChain
+from langchain_openai import ChatOpenAI
+llm = ChatOpenAI(
+    model="qwen3-235b",
+    api_key=os.environ["HYPNEX_API_KEY"],
+    base_url="https://api.mor.org/api/v1",
+)
+
+# CrewAI
+from crewai import LLM
+llm = LLM(
+    model="openai/qwen3-235b",
+    api_key=os.environ["HYPNEX_API_KEY"],
+    base_url="https://api.mor.org/api/v1",
+)
+
+# llama-index
+from llama_index.llms.openai_like import OpenAILike
+llm = OpenAILike(
+    model="qwen3-235b",
+    api_base="https://api.mor.org/api/v1",
+    api_key=os.environ["HYPNEX_API_KEY"],
+    is_chat_model=True,
+)
+
+# instructor
+import instructor
+client = instructor.from_openai(HypnexOpenAI())
+```
+
+## Morpheus-specific endpoints
+
+`client.morpheus.*` exposes endpoints that have no OpenAI equivalent:
+
+| Method | What it does |
+|---|---|
+| `balance()` | Current MOR balance |
+| `transactions(limit=50)` | Billing history |
+| `spending()` | Cumulative usage |
+| `me()` | User profile |
+| `list_keys()` / `create_key(name)` / `delete_key(id)` / `set_default_key(id)` | API keys |
+| `link_wallet(addr, sig, msg)` / `get_wallet()` / `unlink_wallet()` | Wallet binding |
+| `active_models()` / `find_model(name)` / `models_by_type(type)` | Public registry |
+
+## CLI
+
+```bash
+hypnex models                          # list
+hypnex health                          # show api.mor.org health
+hypnex chat "Hello" --model glm-5      # one-shot
+```
+
+## Async
+
+```python
+from hypnex_openai import AsyncHypnexOpenAI
+client = AsyncHypnexOpenAI(api_key="mor_...")
+r = await client.chat.completions.create(...)
+```
+
+## Environment
+
+- `HYPNEX_API_KEY` — your API key (required)
+- `HYPNEX_BASE_URL` — override base URL (default `https://api.mor.org/api/v1`)
+
+## Tests
+
+```bash
+pip install -e ".[dev]"
+pytest                                   # public smoke tests
+HYPNEX_API_KEY=mor_... pytest          # also run authenticated tests
+```
+
+## License
+
+MIT

hypnex_openai-0.1.0/examples/01_basic_chat.py

@@ -0,0 +1,21 @@
+"""Basic chat completion against the Morpheus inference network.
+
+Run:  HYPNEX_API_KEY=mor_... python examples/01_basic_chat.py
+Get a key at https://app.mor.org.
+"""
+
+import os
+
+from hypnex_openai import HypnexOpenAI
+
+client = HypnexOpenAI(api_key=os.environ["HYPNEX_API_KEY"])
+
+response = client.chat.completions.create(
+    model="mistral-31-24b",
+    messages=[
+        {"role": "system", "content": "You are a concise assistant."},
+        {"role": "user", "content": "Explain Morpheus AI in one sentence."},
+    ],
+)
+
+print(response.choices[0].message.content)

hypnex_openai-0.1.0/examples/02_streaming.py

@@ -0,0 +1,22 @@
+"""Streaming chat completion (SSE).
+
+Run:  HYPNEX_API_KEY=mor_... python examples/02_streaming.py
+"""
+
+import os
+
+from hypnex_openai import HypnexOpenAI
+
+client = HypnexOpenAI(api_key=os.environ["HYPNEX_API_KEY"])
+
+stream = client.chat.completions.create(
+    model="qwen3-235b",
+    messages=[{"role": "user", "content": "Count from 1 to 10, one per line."}],
+    stream=True,
+)
+
+for chunk in stream:
+    delta = chunk.choices[0].delta
+    if delta and delta.content:
+        print(delta.content, end="", flush=True)
+print()

hypnex_openai-0.1.0/examples/03_langchain.py

@@ -0,0 +1,28 @@
+"""LangChain integration — point ChatOpenAI at Morpheus.
+
+ChatOpenAI accepts a base_url and api_key, so swapping providers is a
+2-line change. Use any Morpheus model in the `model=` field.
+
+Install:  pip install langchain langchain-openai
+Run:      HYPNEX_API_KEY=mor_... python examples/03_langchain.py
+"""
+
+import os
+
+from langchain_core.messages import HumanMessage, SystemMessage
+from langchain_openai import ChatOpenAI
+
+llm = ChatOpenAI(
+    model="qwen3-235b",
+    api_key=os.environ["HYPNEX_API_KEY"],
+    base_url="https://api.mor.org/api/v1",
+    temperature=0.7,
+)
+
+response = llm.invoke(
+    [
+        SystemMessage(content="You are concise."),
+        HumanMessage(content="Why is decentralized inference important?"),
+    ]
+)
+print(response.content)

hypnex_openai-0.1.0/examples/04_crewai.py

@@ -0,0 +1,35 @@
+"""CrewAI integration — replace OpenAI LLM with Morpheus.
+
+CrewAI uses a "provider/model" naming convention; "openai/<morpheus-model>"
+routes through the OpenAI-compatible client at the supplied base_url.
+
+Install:  pip install crewai
+Run:      HYPNEX_API_KEY=mor_... python examples/04_crewai.py
+"""
+
+import os
+
+from crewai import LLM, Agent, Crew, Task
+
+morpheus_llm = LLM(
+    model="openai/qwen3-coder-480b-a35b-instruct",
+    api_key=os.environ["HYPNEX_API_KEY"],
+    base_url="https://api.mor.org/api/v1",
+)
+
+researcher = Agent(
+    role="Researcher",
+    goal="Produce concise, accurate summaries.",
+    backstory="A meticulous researcher who values brevity.",
+    llm=morpheus_llm,
+    allow_delegation=False,
+)
+
+task = Task(
+    description="Summarize the four pools of the Morpheus protocol.",
+    expected_output="A 3-sentence summary covering Capital, Code, Compute, Community.",
+    agent=researcher,
+)
+
+crew = Crew(agents=[researcher], tasks=[task], verbose=False)
+print(crew.kickoff())

hypnex_openai-0.1.0/examples/05_morpheus_extras.py

@@ -0,0 +1,45 @@
+"""Demonstrate Morpheus-specific endpoints (no OpenAI equivalent).
+
+Most of these require a valid HYPNEX_API_KEY:
+  - balance() / transactions() / spending()
+  - me() / list_keys() / create_key() / delete_key()
+  - link_wallet() / get_wallet() / unlink_wallet()
+
+These do NOT require auth (they hit the public registry):
+  - active_models() / find_model() / models_by_type()
+
+Run:  python examples/05_morpheus_extras.py
+"""
+
+import os
+
+from hypnex_openai import HypnexOpenAI
+
+# A dummy key works for the public registry calls. Use a real key for
+# authenticated endpoints.
+client = HypnexOpenAI(
+    api_key=os.environ.get("HYPNEX_API_KEY", "dummy-for-public-calls")
+)
+
+print("First 10 active models:\n")
+for m in client.morpheus.active_models()[:10]:
+    fee_mor = (m.get("fee") or 0) / 1e18
+    print(f"  {m['name']:<42} type={m['type']:<10} fee={fee_mor:.4f} MOR")
+
+print("\nLLMs only:")
+for m in client.morpheus.models_by_type("LLM"):
+    print(f"  {m['name']}")
+
+print("\nLook up a specific model:")
+mistral = client.morpheus.find_model("mistral-31-24b")
+print(f"  mistral-31-24b → owner {mistral['owner']}" if mistral else "  not found")
+
+if os.environ.get("HYPNEX_API_KEY"):
+    print("\nAuthenticated calls:")
+    try:
+        print(f"  me():      {client.morpheus.me()}")
+        print(f"  balance(): {client.morpheus.balance()}")
+    except Exception as e:
+        print(f"  call failed (likely invalid API key): {e}")
+else:
+    print("\n(set HYPNEX_API_KEY to also see balance / me / keys)")

hypnex_openai-0.1.0/examples/06_async.py

@@ -0,0 +1,34 @@
+"""Async client example.
+
+Run:  HYPNEX_API_KEY=mor_... python examples/06_async.py
+"""
+
+import asyncio
+import os
+
+from hypnex_openai import AsyncHypnexOpenAI
+
+
+async def main() -> None:
+    client = AsyncHypnexOpenAI(api_key=os.environ["HYPNEX_API_KEY"])
+    try:
+        # Run two requests concurrently.
+        a, b = await asyncio.gather(
+            client.chat.completions.create(
+                model="mistral-31-24b",
+                messages=[{"role": "user", "content": "Say hello in French."}],
+            ),
+            client.chat.completions.create(
+                model="qwen3-235b",
+                messages=[{"role": "user", "content": "Say hello in Japanese."}],
+            ),
+        )
+        print("mistral:", a.choices[0].message.content)
+        print("qwen:   ", b.choices[0].message.content)
+    finally:
+        await client.close()
+        await client.morpheus.aclose()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

hypnex_openai-0.1.0/examples/07_tools.py

@@ -0,0 +1,70 @@
+"""Tool / function calling. Works with any Morpheus model that supports tools.
+
+Run:  HYPNEX_API_KEY=mor_... python examples/07_tools.py
+"""
+
+import json
+import os
+
+from hypnex_openai import HypnexOpenAI
+
+client = HypnexOpenAI(api_key=os.environ["HYPNEX_API_KEY"])
+
+tools = [
+    {
+        "type": "function",
+        "function": {
+            "name": "get_weather",
+            "description": "Get the current weather for a city.",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "city": {"type": "string", "description": "City name"},
+                    "units": {
+                        "type": "string",
+                        "enum": ["celsius", "fahrenheit"],
+                        "default": "celsius",
+                    },
+                },
+                "required": ["city"],
+            },
+        },
+    }
+]
+
+
+def get_weather(city: str, units: str = "celsius") -> dict:
+    return {"city": city, "temp": 22 if units == "celsius" else 72, "units": units}
+
+
+messages = [{"role": "user", "content": "What's the weather in Paris?"}]
+
+resp = client.chat.completions.create(
+    model="qwen3-coder-480b-a35b-instruct",
+    messages=messages,
+    tools=tools,
+)
+
+msg = resp.choices[0].message
+
+if msg.tool_calls:
+    for call in msg.tool_calls:
+        args = json.loads(call.function.arguments)
+        result = get_weather(**args)
+        messages.append(msg.model_dump())
+        messages.append(
+            {
+                "role": "tool",
+                "tool_call_id": call.id,
+                "content": json.dumps(result),
+            }
+        )
+
+    final = client.chat.completions.create(
+        model="qwen3-coder-480b-a35b-instruct",
+        messages=messages,
+        tools=tools,
+    )
+    print(final.choices[0].message.content)
+else:
+    print(msg.content)

hypnex_openai-0.1.0/examples/08_embeddings.py

@@ -0,0 +1,22 @@
+"""Embeddings via the Morpheus network.
+
+Run:  HYPNEX_API_KEY=mor_... python examples/08_embeddings.py
+"""
+
+import os
+
+from hypnex_openai import HypnexOpenAI
+
+client = HypnexOpenAI(api_key=os.environ["HYPNEX_API_KEY"])
+
+resp = client.embeddings.create(
+    model="text-embedding-bge-m3",
+    input=[
+        "Morpheus is a decentralized AI network.",
+        "Bittensor is a decentralized ML network.",
+    ],
+)
+
+for i, item in enumerate(resp.data):
+    vec = item.embedding
+    print(f"vector {i}: dim={len(vec)} first5={vec[:5]}")

hypnex_openai-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "hypnex-openai"
+version = "0.1.0"
+description = "Drop-in OpenAI client for the Morpheus decentralized inference network (mor.org)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+authors = [{ name = "Hypnex Labs" }]
+keywords = ["openai", "morpheus", "llm", "ai", "decentralized", "crypto", "agents"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "openai>=1.50.0,<2.0.0",
+    "httpx>=0.27.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "ruff>=0.5",
+]
+
+[project.scripts]
+hypnex = "hypnex_openai.__main__:main"
+
+[project.urls]
+Homepage = "https://hypnex.xyz"
+Documentation = "https://docs.hypnex.xyz"
+Repository = "https://github.com/hypnex-labs/hypnex"
+Issues = "https://github.com/hypnex-labs/hypnex/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hypnex_openai"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"