n8n-nodes-vercel-ai-sdk-universal

A comprehensive collection of Universal n8n nodes powered by the Vercel AI SDK. These nodes provide a unified interface to interact with multiple AI providers for text generation, structured data, embeddings, image generation, speech synthesis, and transcription.

🚀 Features

• Unified Interface: Switch between AI providers (Google, OpenAI, Anthropic, Groq, etc.) without changing your workflow logic.
• Universal AI: Text and object generation with streaming, tools, and multimodal support.
• Universal Agent: Orchestrate autonomous agents using Letta.
• Specialized Nodes: Dedicated nodes for Embeddings, Image Generation, Speech Synthesis, and Transcription.
• Advanced Capabilities: Support for caching, search grounding, thinking models, and rich metadata outputs.

🛠️ Supported Providers

| Provider | Text/Chat | Embedding | Image | Speech | Transcription | | :--- | :---: | :---: | :---: | :---: | :---: | | Google Gemini | ✅ | ✅ | ✅ | ✅ | - | | OpenAI | ✅ | ✅ | ✅ | ✅ | ✅ | | DeepSeek | ✅ | - | - | - | - | | Groq | ✅ | - | - | - | - | | OpenRouter | ✅ | - | - | - | - | | Letta | (Agent) | - | - | - | - |

(Note: Anthropic is a dependency but currently lacks a dedicated credential interface in this package)

📦 Installation

For n8n Users

Follow the n8n community node installation guide. Search for n8n-nodes-vercel-ai-sdk-universal.

For Developers

1. Clone the repository:

   git clone https://github.com/etircopyh/n8n-nodes-vercel-ai-sdk-universal.git
   cd n8n-nodes-vercel-ai-sdk-universal

2. Install dependencies: This project uses bun or npm.

   npm install
   # or
   bun install

3. Build the project:

   npm run build

🔧 Usage & Nodes

Universal AI

The powerhouse node for generation.

• Operations: Generate Text, Generate Object.
• Key Features:
  • Streaming: Real-time output chunks.
  • Tools: Connect to Google Search, Code Execution, or custom functions.
  • Multimodal: Accept images, PDFs, and video as input.
  • JSON Schema: Enforce structured outputs.

Universal Agent

Manage stateful agents with Letta.

• Operations: Chat, Manage Agent, Manage Identity, Tools, Blocks, Memory.
• Use Case: create persistent agents that remember user context across sessions.

Universal Embedding

Vectorize text for RAG (Retrieval-Augmented Generation) pipelines.

• Supports: Batch embedding, specific task types (for Google models).

Universal Image Generation

Create visual assets.

• Features: Aspect ratio control, style presets, safety filter configuration.

Universal Speech & Transcription

Audio processing capabilities.

• Speech: Text-to-Speech with various voices and speed controls.
• Transcription: Audio-to-Text (Whisper) with timestamping.

💻 Development

Project Structure

• nodes/: Source code for n8n nodes.
  • UniversalAI/: Core generation logic.
  • UniversalAgent/: Letta integration (uses Handler pattern).
  • shared/: Shared utilities, types, and providers.
• credentials/: Authentication definitions.
• __tests__/: Jest test suites.

Scripts

• npm run dev: Build and watch for changes.
• npm run build: Compile TypeScript and build icons.
• npm run test: Run unit tests.
• npm run lint: Run ESLint.
• npm run format: Format code with Prettier.

Testing

Run the test suite using Jest:

npm run test

To run tests in watch mode:

npm run test:watch

🤝 Contribution

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes.
4. Push to the branch.
5. Open a Pull Request.

Guidelines:

• Ensure all tests pass.
• Add new tests for new features.
• Follow the existing code style (Prettier/ESLint).

📄 License

MIT License. See LICENSE.md for details.

📞 Contact

Author: etircopyh Repository: github.com/etircopyh/n8n-nodes-vercel-ai-sdk-universal