neoncodex-ai 1.0.0

Official Python SDK for NeonCodex AI — Claude, GPT-5.5, Gemini

neoncodex

Official Python SDK for NeonCodex AI — Claude 4.6, GPT-5.5, Gemini 3.1 Pro, and 50+ models.

Install

pip install neoncodex

For async support:

pip install neoncodex[async]

Quick start

from neoncodex import NeonCodex

client = NeonCodex(api_key="nck_live_...")

# Run a task and get full output
output = client.tasks.run("Write a Python web scraper for HN")
print(output)

# Stream output in real time
for chunk in client.tasks.stream("Explain transformers in ML"):
    print(chunk, end="", flush=True)

# With file attachment
attachment = client.files.from_path("data.csv")
output = client.tasks.run(
    "Analyze this data and find key insights",
    attachments=[attachment]
)

Async

import asyncio
from neoncodex import NeonCodex

client = NeonCodex(api_key="nck_live_...")

async def main():
    async for chunk in client.tasks.astream("Write a FastAPI app"):
        print(chunk, end="", flush=True)

asyncio.run(main())

Models

# Auto-routing (recommended)
client.tasks.run("Your prompt", model="auto")

# Specific models
client.tasks.run("Debug this code", model="claude-sonnet-4-6")
client.tasks.run("Analyze this dataset", model="google/gemini-3.1-pro-preview")
client.tasks.run("Quick question", model="qwen/qwen3-coder:free")  # free

API Reference

client.tasks.run(prompt, model, attachments) → str

client.tasks.stream(prompt, model, attachments) → Iterator[str]

client.tasks.create(prompt, model, title, attachments) → Task

client.tasks.get(task_id) → Task

client.tasks.wait(task_id, poll_interval, timeout) → Task

client.tasks.list(limit) → List[Task]

client.tasks.cancel(task_id) → None

client.files.from_path(file_path) → Attachment

client.files.from_string(content, filename) → Attachment

client.me() → User

Error handling

from neoncodex import NeonCodex, NeonCodexError, AuthenticationError

try:
    output = client.tasks.run("...")
except AuthenticationError:
    print("Invalid API key")
except NeonCodexError as e:
    print(f"Error {e.status_code}: {e}")

Get an API key

neoncodex.io → Settings → API Keys

License

MIT