Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/workflows/live-matrix.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ jobs:
# the suite reads.
#
# A separate job rather than a step on the sweep below. The sweep's steps
# carry forty provider secrets and this suite needs exactly one, and the
# carry many provider credentials and this suite needs exactly one, and the
# sweep is long enough that appending to it would queue the parity run
# behind every other provider. The cost is a second build per nightly run.
reasoning-parity:
Expand Down Expand Up @@ -250,7 +250,7 @@ jobs:
REPLICATE_API_TOKEN: ${{ secrets.REPLICATE_API_TOKEN }}

# Two more single-credential live suites, grouped the way reasoning-parity
# above is: the sweep's steps carry forty provider secrets and each of
# above is: the sweep's steps carry many provider credentials and each of
# these needs exactly one (ANTHROPIC_API_KEY), so appending either to the
# sweep would queue it behind every other provider for no reason. Unlike
# reasoning-parity, the two are combined into one job rather than split
Expand Down
4 changes: 2 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Guidance for Claude Code when working in this repository.

## Project Overview

NeuroLink is a unified AI development platform shipping as both a **TypeScript SDK** and **CLI**. It wraps a wide range of AI and voice providers across three inference types (`generate`, `stream`, `decide`) (OpenAI, Anthropic, Google AI Studio, Vertex, AWS Bedrock, Azure, Mistral, LiteLLM, SageMaker, Hugging Face, Ollama, OpenAI-compatible, DeepSeek, NVIDIA NIM, LM Studio, llama.cpp, OpenRouter, Cerebras, SambaNova, ElevenLabs, Deepgram, Azure Speech, Fish Audio, Cartesia, and more) behind a single consistent API, with full MCP support, multimodal file processing, voice (TTS/STT/realtime), media generation (image / video / music / avatar with Kling / Runway / Replicate / Beatoven / Lyria / D-ID / HeyGen handlers), RAG pipelines, observability, and a workflow engine.
NeuroLink is a unified AI development platform shipping as both a **TypeScript SDK** and **CLI**. It wraps AI providers across three inference types (`generate`, `stream`, `decide`) (OpenAI, Anthropic, Google AI Studio, Vertex, AWS Bedrock, Azure, Mistral, LiteLLM, SageMaker, Hugging Face, Ollama, OpenAI-compatible, DeepSeek, NVIDIA NIM, LM Studio, llama.cpp, OpenRouter, Cerebras, SambaNova, ElevenLabs, Deepgram, Azure Speech, Fish Audio, Cartesia, and more) behind a single consistent API, with full MCP support, multimodal file processing, voice (TTS/STT/realtime), media generation (image / video / music / avatar with Kling / Runway / Replicate / Beatoven / Lyria / D-ID / HeyGen handlers), RAG pipelines, observability, and a workflow engine.

---

Expand Down Expand Up @@ -181,7 +181,7 @@ Registry → holds factory functions (via dynamic import)
src/
├── lib/
│ ├── neurolink.ts # Main SDK entry point
│ ├── providers/ # AI provider implementations (40 registered)
│ ├── providers/ # AI provider implementations
│ ├── factories/ # ProviderFactory + ProviderRegistry
│ ├── core/ # BaseProvider, constants, infrastructure
│ ├── adapters/ # Provider-specific content adapters (image, TTS, video)
Expand Down
6 changes: 3 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -282,7 +282,7 @@ For logger levels, structured fields, redaction, and performance guidance, see

## Testing

NeuroLink has a comprehensive testing suite to ensure reliability across all AI providers and features. Please add tests for any new features or bug fixes.
NeuroLink has a comprehensive testing suite to ensure reliability across supported AI providers and features. Please add tests for any new features or bug fixes.

### 🚀 Quick Start Testing

Expand Down Expand Up @@ -390,7 +390,7 @@ pnpm exec tsx test/continuous-test-suite-issue-01-model-access.ts
pnpm test:ci

# Individual domain validations
pnpm test:providers # 21+ provider validation
pnpm test:providers # AI provider validation
pnpm test:performance # Performance benchmarks (tools/testing/performanceMonitor.ts)
pnpm test:voice # Voice (TTS/STT) validation
pnpm test:rag # RAG pipeline validation
Expand Down Expand Up @@ -444,7 +444,7 @@ pnpm test
We maintain integration coverage across:

- ✅ **Core functionality** — All primary features tested
- ✅ **Provider integration** — All 21+ AI providers validated
- ✅ **Provider integration** — Supported AI providers validated
- ✅ **Voice pipeline** — TTS, STT, and realtime voice servers
- ✅ **Error handling** — Graceful failure scenarios
- ✅ **MCP integration** — Tool orchestration and configuration
Expand Down
20 changes: 10 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -210,7 +210,7 @@ const neurolink = new NeuroLink({
- **Video Generation with Veo** (v8.32.0) – Video generation via Google Veo 3.1 on Vertex AI. 720p/1080p, portrait/landscape. → [Guide](docs/features/video-generation.md)
- **Image Generation** (v8.31.0) – Native image generation with Gemini and Imagen models. → [Guide](docs/image-generation-streaming.md)
- **HTTP/Streamable HTTP Transport** (v8.29.0) – Remote MCP servers via HTTP with auth headers, retry, rate limiting. → [Guide](docs/mcp-http-transport.md)
- **PPT Generation** – 35 slide types, 5 themes, optional AI-generated images. Works across all major providers. → [Guide](docs/features/ppt-generation.md)
- **PPT Generation** – 35 slide types, 5 themes, optional AI-generated images. Works across supported AI providers. → [Guide](docs/features/ppt-generation.md)
- **Structured Output with Zod** – Type-safe JSON via `schema` + `output.format: "json"`. → [Guide](docs/features/structured-output.md)
- **CSV & PDF File Support** – Attach CSV/PDF with auto-detection. PDF: native visual analysis on Vertex, Anthropic, Bedrock, AI Studio. → [CSV](docs/features/multimodal-chat.md#csv-file-support) | [PDF](docs/features/pdf-support.md)
- **LiteLLM, SageMaker & OpenRouter** – 100+ models via LiteLLM, custom endpoints on SageMaker, 300+ via OpenRouter. → [LiteLLM](docs/litellm-integration.md) | [SageMaker](docs/sagemaker-integration.md)
Expand Down Expand Up @@ -424,7 +424,7 @@ npx @juspay/neurolink --help

### Configuration

NeuroLink works with every major AI provider — and local runtimes that need no API key at all. You'll need at least one to get started:
NeuroLink works with a broad set of AI providers — and local runtimes that need no API key at all. You'll need at least one to get started:

**Option 1: Interactive Setup (Recommended)**

Expand Down Expand Up @@ -611,7 +611,7 @@ const result = await neurolink.generate({
### Next Steps

- **[Complete Documentation](https://docs.neurolink.ink)** - Comprehensive guides and API reference
- **[Provider Setup Guide](docs/getting-started/provider-setup.md)** - Configure any provider
- **[Provider Setup Guide](docs/getting-started/provider-setup.md)** - Configure a provider
- **[SDK API Reference](docs/sdk/api-reference.md)** - Full TypeScript API documentation
- **[CLI Command Reference](docs/cli/commands.md)** - Complete CLI documentation
- **[Example Projects](docs/examples/index.md)** - Real-world integration examples
Expand Down Expand Up @@ -643,7 +643,7 @@ NeuroLink is a comprehensive AI development platform. Every feature below is shi

### 🤖 AI Provider Integration

**Every provider neuron behind one API** - Switch providers with a single parameter change. Nearly all serve `generate`/`stream`; TypeSafe Jev and Laya serve `decide` instead. Tool support: 31 native tool-calling, 3 model-dependent, 10 that serve no tools at all (embedding-, media- and decision-only). 3 are fully local runtimes (Ollama, LM Studio, llama.cpp) and 4 need zero configuration to start (those three plus LiteLLM) — no cloud account, no API key. 9 providers (OpenAI, Google AI Studio, Google Vertex, Amazon Bedrock, Cohere, Ollama, LiteLLM, Voyage, Jina) expose `embed()`/`embedMany()` natively for RAG and custom vector search.
**Provider neurons behind one API** - Switch providers with a single parameter change. Nearly all serve `generate`/`stream`; TypeSafe Jev and Laya serve `decide` instead. Tool support: 31 native tool-calling, 3 model-dependent, 10 that serve no tools at all (embedding-, media- and decision-only). 3 are fully local runtimes (Ollama, LM Studio, llama.cpp) and 4 need zero configuration to start (those three plus LiteLLM) — no cloud account, no API key. 9 providers (OpenAI, Google AI Studio, Google Vertex, Amazon Bedrock, Cohere, Ollama, LiteLLM, Voyage, Jina) expose `embed()`/`embedMany()` natively for RAG and custom vector search.

| Provider | Models | Free Tier | Tool Support | Status | Documentation |
| --------------------- | -------------------------------------------------------------------------- | --------------- | ------------ | ------------- | ----------------------------------------------------------------------------------------------------------------------------- |
Expand Down Expand Up @@ -682,13 +682,13 @@ NeuroLink is a comprehensive AI development platform. Every feature below is shi
**Decision-only providers:** **TypeSafe Jev** (`TYPESAFE_API_KEY`) and **Laya** (`LAYA_API_KEY` + `LAYA_BASE_URL`) do not appear in the table above because neither serves `generate`/`stream` — they are the two providers for the `decide` inference type, TypeSafe first when both are configured. See [Decide: Calibrated Judgments, Not Text](#decide-calibrated-judgments-not-text).

**[📖 Provider Comparison Guide](docs/reference/provider-comparison.md)** - Detailed feature matrix and selection criteria
**[🔬 Provider Feature Compatibility](docs/reference/provider-feature-compatibility.md)** - Test-based compatibility reference for all 19 features across every provider
**[🔬 Provider Feature Compatibility](docs/reference/provider-feature-compatibility.md)** - Test-based compatibility reference for 19 features (dated snapshot covering a subset of the full provider list)

---

### 🔧 Built-in Tools & MCP Integration

**6 Core Tools** (work across all providers, zero configuration):
**6 Core Tools** (work across supported providers, zero configuration):

| Tool | Purpose | Auto-Available | Documentation |
| -------------------- | ------------------------ | ----------------------- | ------------------------------------------ |
Expand Down Expand Up @@ -868,7 +868,7 @@ neurolink generate "Describe what happens" --file ./demo.mp4
- **ProcessorRegistry** - Priority-based processor selection with fallback
- **OWASP Security** - HTML/SVG sanitization prevents XSS attacks
- **Auto-detection** - FileDetector identifies file types by extension and content
- **Provider-agnostic** - All processors work across every AI provider
- **Provider-agnostic** - Processors work across supported AI providers

**[📖 File Processors Guide](docs/features/file-processors.md)** - Complete reference for all file types

Expand Down Expand Up @@ -998,7 +998,7 @@ node your-app.js

### 🤖 GitHub Action

Run AI-powered workflows directly in GitHub Actions with support for every provider and automatic PR/issue commenting.
Run AI-powered workflows directly in GitHub Actions with broad provider support and automatic PR/issue commenting.

```yaml
- uses: juspay/neurolink@v1
Expand All @@ -1010,7 +1010,7 @@ Run AI-powered workflows directly in GitHub Actions with support for every provi

| Feature | Description |
| ---------------------- | ----------------------------------------------------------------------------------------- |
| **Multi-Provider** | Every provider behind one unified interface |
| **Multi-Provider** | Broad provider support behind one unified interface |
| **PR/Issue Comments** | Auto-post AI responses with intelligent updates |
| **Multimodal Support** | Attach images, PDFs, CSVs, Excel, Word, JSON, YAML, XML, HTML, SVG, code files to prompts |
| **Cost Tracking** | Built-in analytics and quality evaluation |
Expand Down Expand Up @@ -1203,7 +1203,7 @@ Full command and API breakdown lives in [`docs/cli/commands.md`](docs/cli/comman

| Capability | Highlights |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Provider unification** | Every provider neuron behind one API, with automatic fallback, cost-aware routing, `providerFallback` policy, `modelChain` config. |
| **Provider unification** | Provider neurons behind one API, with automatic fallback, cost-aware routing, `providerFallback` policy, `modelChain` config. |
| **Decision inference** | Third inference type (`decide`) alongside generate/stream: calibrated `boolean`/`choice`/`score` judgments via TypeSafe Jev (~400ms flat, ~$0.00002/decision) or Laya, a self-hosted open-weights alternative. Used internally for model routing, context budgeting, relevance compaction and tool routing; per-query RAG planning is opt-in via `RAGPipeline`. |
| **Multimodal pipeline** | Stream images + CSV data + PDF documents across providers with local/remote assets. Auto-detection for mixed file types. |
| **Voice pipeline** | TTS (6 providers: Google, OpenAI, ElevenLabs, Azure, Fish Audio, Cartesia) + STT (4 providers) + realtime voice APIs (OpenAI Realtime, Gemini Live). |
Expand Down
2 changes: 1 addition & 1 deletion action.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
name: "NeuroLink AI"
description: "Run AI-powered workflows with 13 providers (OpenAI, Anthropic, Google, AWS, Azure, and more)"
description: "Run AI-powered workflows across AI providers (OpenAI, Anthropic, Google, AWS, Azure, and more)"
author: "Juspay Technologies"

branding:
Expand Down
2 changes: 1 addition & 1 deletion docs-site/docusaurus.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import { redirectsPluginConfig } from "./config/redirects";
const config: Config = {
title: "NeuroLink",
tagline:
"Enterprise AI Development Platform - Universal provider support, MCP integration, and professional CLI",
"Enterprise AI Development Platform - broad provider support, MCP integration, and professional CLI",
favicon: "img/favicon.svg",

// Production URL - custom domain
Expand Down
2 changes: 1 addition & 1 deletion docs-site/scripts/sync-docs.ts
Original file line number Diff line number Diff line change
Expand Up @@ -668,7 +668,7 @@ function processFrontmatter(
}
if (!processed.description) {
processed.description =
"Enterprise AI Development Platform - Universal provider support, MCP integration, and professional CLI";
"Enterprise AI Development Platform - unified provider support, MCP integration, and professional CLI";
}
processed.slug = "/";
}
Expand Down
10 changes: 5 additions & 5 deletions docs-site/src/pages/index.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ const QUICK_LINKS = [
},
{
title: "SDK Guide",
description: "Unified API for 44 providers",
description: "Unified API for supported providers",
href: "/docs/sdk",
icon: "📦",
},
Expand All @@ -57,7 +57,7 @@ const QUICK_LINKS = [
},
{
title: "Provider Setup",
description: "Configure any AI provider",
description: "Configure a supported AI provider",
href: "/docs/getting-started/provider-setup",
icon: "⚡",
},
Expand Down Expand Up @@ -170,7 +170,7 @@ export default function Home(): React.JSX.Element {
return (
<Layout
title="NeuroLink - The Nervous System Pipe for AI Streams"
description="The pipe layer for the AI nervous system. Stream tokens, data, tools, voice, and context from 44 providers through pluggable connectors."
description="The pipe layer for the AI nervous system. Stream tokens, data, tools, voice, and context from supported providers through pluggable connectors."
>
<Head>
<script type="application/ld+json">{JSON.stringify(FAQ_JSONLD)}</script>
Expand Down Expand Up @@ -226,8 +226,8 @@ export default function Home(): React.JSX.Element {
<span className={styles.routingCardLabel}>THE PIPE</span>
<p className={styles.routingCardTitle}>Start with the pipe</p>
<p className={styles.routingCardDesc}>
Unified API for 44 AI providers. Token streams, voice, memory,
tools, RAG — one consistent interface.
Unified API for supported AI providers. Token streams, voice,
memory, tools, RAG — one consistent interface.
</p>
</a>
<a href="/docs/features/mcp-tools" className={styles.routingCard}>
Expand Down
Loading
Loading