diff --git a/docs.json b/docs.json index 0ab1f09..f6821c8 100644 --- a/docs.json +++ b/docs.json @@ -226,7 +226,8 @@ "v3/integrations/langchain", "v3/integrations/pydantic-ai", "v3/integrations/aisuite", - "v3/integrations/haystack" + "v3/integrations/haystack", + "v3/integrations/atomic-agents" ] }, { @@ -235,7 +236,8 @@ "expanded": false, "pages": [ "v3/integrations/bifrost", - "v3/integrations/lynkr" + "v3/integrations/lynkr", + "v3/integrations/open-connector" ] }, { @@ -267,7 +269,8 @@ "expanded": false, "pages": [ "v3/integrations/librechat", - "v3/integrations/open-webui" + "v3/integrations/open-webui", + "v3/integrations/deeptutor" ] }, { diff --git a/integration-logo/atomic-agents-icondoc.svg b/integration-logo/atomic-agents-icondoc.svg new file mode 100644 index 0000000..ed4007a --- /dev/null +++ b/integration-logo/atomic-agents-icondoc.svg @@ -0,0 +1,11 @@ + + + + + + + + + + + diff --git a/integration-logo/deeptutor-icondoc.svg b/integration-logo/deeptutor-icondoc.svg new file mode 100644 index 0000000..11d7937 --- /dev/null +++ b/integration-logo/deeptutor-icondoc.svg @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/integration-logo/open-connector-icondoc.svg b/integration-logo/open-connector-icondoc.svg new file mode 100644 index 0000000..f89b0c5 --- /dev/null +++ b/integration-logo/open-connector-icondoc.svg @@ -0,0 +1,9 @@ + + + + + + + + + diff --git a/v3/integrations/atomic-agents.mdx b/v3/integrations/atomic-agents.mdx new file mode 100644 index 0000000..d8c5348 --- /dev/null +++ b/v3/integrations/atomic-agents.mdx @@ -0,0 +1,128 @@ +--- +title: "Atomic Agents" +icon: "/integration-logo/atomic-agents-icondoc.svg" +description: "Use Atomic Agents with Eden AI to build agents on 500+ AI models through an OpenAI-compatible, Instructor-powered interface." +--- + +import { TechArticleSchema } from "/snippets/TechArticleSchema.mdx"; + + + +Use Atomic Agents with Eden AI to build agents on 500+ AI models through an OpenAI-compatible, Instructor-powered interface. + +## Overview + +[Atomic Agents](https://github.com/Eigenwise/atomic-agents) is a lightweight, modular Python framework for building AI agents on composable, schema-driven building blocks (via [Instructor](https://github.com/instructor-ai/instructor) and Pydantic). Atomic Agents works with Eden AI out of the box through its existing OpenAI-compatible client, so your agents reach models from OpenAI, Anthropic, Google, Mistral and more behind one key, with EU-based, GDPR-aligned inference. + +## Installation + +Eden AI reuses the OpenAI client and Instructor that Atomic Agents already relies on: + + +```bash pip +pip install atomic-agents openai instructor +``` + +```bash poetry +poetry add atomic-agents openai instructor +``` + + +## Quick Start + +Wrap an OpenAI client pointed at Eden AI with Instructor — the same pattern used for any other OpenAI-compatible provider — and pass it to your agent: + + +```bash .env +EDENAI_API_KEY=your_api_key_here +``` + +{/* skip-test */} +```python Python +import os +import instructor +from openai import OpenAI +from atomic_agents.agents.base_agent import BaseAgent, BaseAgentConfig + +client = instructor.from_openai( + OpenAI( + base_url="https://api.edenai.run/v3", + api_key=os.getenv("EDENAI_API_KEY"), + ) +) + +agent = BaseAgent( + config=BaseAgentConfig( + client=client, + model="anthropic/claude-sonnet-5", # / + ) +) + +response = agent.run(agent.input_schema(chat_message="Hello! How are you?")) +print(response.chat_message) +``` + + +Both Instructor `TOOLS` and `JSON` modes work unchanged with Eden AI. + +## Switching models + +Change the `model` string on `BaseAgentConfig` to reach any Eden AI model — no per-provider SDKs, no code changes: + + +{/* skip-test */} +```python Python +for model in [ + "openai/gpt-5.5", + "anthropic/claude-sonnet-5", + "mistral/mistral-large-2512", +]: + agent = BaseAgent(config=BaseAgentConfig(client=client, model=model)) + response = agent.run(agent.input_schema(chat_message="Write a haiku about the sea.")) + print(model, "->", response.chat_message) +``` + + +## Available Models + +Use the `provider/model` format for any Eden AI model: + +**OpenAI** +- `openai/gpt-5.5` +- `openai/gpt-5-mini` + +**Anthropic** +- `anthropic/claude-sonnet-5` +- `anthropic/claude-haiku-4-5` + +**Google** +- `google/gemini-2.5-pro` +- `google/gemini-3.5-flash` + +**Mistral** +- `mistral/mistral-large-2512` +- `mistral/mistral-small-2603` + +## Environment Variables + + +```bash .env +EDENAI_API_KEY=your_api_key_here +``` + + +## Next Steps + +- [aisuite](/v3/integrations/aisuite) - Another OpenAI-style multi-provider interface +- [Chat Completions](/v3/llms/chat-completions) - Core LLM endpoint +- [List LLM Models](/v3/llms/listing-models) - Browse available providers and models diff --git a/v3/integrations/deeptutor.mdx b/v3/integrations/deeptutor.mdx new file mode 100644 index 0000000..d7f1873 --- /dev/null +++ b/v3/integrations/deeptutor.mdx @@ -0,0 +1,94 @@ +--- +title: "DeepTutor" +icon: "/integration-logo/deeptutor-icondoc.svg" +description: "Use DeepTutor with Eden AI to run your self-hosted study and research app on 500+ AI models through one API." +--- + +import { TechArticleSchema } from "/snippets/TechArticleSchema.mdx"; + + + +Use DeepTutor with Eden AI to run your self-hosted study and research app on 500+ AI models through one API. + +## Overview + +[DeepTutor](https://github.com/HKUDS/DeepTutor) is a self-hosted AI study and research app — chat, quizzes, and RAG knowledge bases. Eden AI is registered as a **built-in gateway provider** in DeepTutor's model registry, so your whole instance can run on models from OpenAI, Anthropic, Google, Mistral and more behind one key, with EU-based, GDPR-aligned inference. + +## Installation + + +```bash pip +mkdir -p my-deeptutor && cd my-deeptutor +pip install -U deeptutor +``` + + +## Quick Start + +Select Eden AI as the LLM provider when the setup wizard prompts for one: + + +```bash Terminal +deeptutor init # prompts for LLM provider / base URL / API key / model +deeptutor start # starts backend + frontend +``` + + +Open the frontend URL printed in the terminal (default `http://127.0.0.1:3782`). Already running an instance? Add or change the provider later from **Settings → Models** in the web UI instead of re-running `init` — DeepTutor auto-detects Eden AI from the base URL. + +## Configuration + +DeepTutor's provider registry stores the profile in `data/user/settings/model_catalog.json`: + +| Field | Value | +|---|---| +| Provider | `edenai` | +| Base URL | `https://api.edenai.run/v3` | +| API key | `EDENAI_API_KEY` | +| Model | `provider/model`, e.g. `anthropic/claude-sonnet-5` | + +## Available Models + +Use the `provider/model` format for any Eden AI model: + +**OpenAI** +- `openai/gpt-5.5` +- `openai/gpt-5-mini` + +**Anthropic** +- `anthropic/claude-sonnet-5` +- `anthropic/claude-haiku-4-5` + +**Google** +- `google/gemini-2.5-pro` +- `google/gemini-3.5-flash` + +**Mistral** +- `mistral/mistral-large-2512` +- `mistral/mistral-small-2603` + +## Environment Variables + + +```bash .env +EDENAI_API_KEY=your_api_key_here +``` + + +DeepTutor reads this key itself once the Eden AI provider is configured — it does not need to be exported manually in most setups (the Settings UI writes it into `model_catalog.json`). + +## Next Steps + +- [Open WebUI](/v3/integrations/open-webui) - Another self-hosted chat interface +- [Chat Completions](/v3/llms/chat-completions) - Core LLM endpoint +- [List LLM Models](/v3/llms/listing-models) - Browse available providers and models diff --git a/v3/integrations/open-connector.mdx b/v3/integrations/open-connector.mdx new file mode 100644 index 0000000..24eb7f5 --- /dev/null +++ b/v3/integrations/open-connector.mdx @@ -0,0 +1,100 @@ +--- +title: "open-connector" +icon: "/integration-logo/open-connector-icondoc.svg" +description: "Use open-connector with Eden AI to expose 500+ AI models through a self-hosted gateway with SDK, CLI, MCP and HTTP access." +--- + +import { TechArticleSchema } from "/snippets/TechArticleSchema.mdx"; + + + +Use open-connector with Eden AI to expose 500+ AI models through a self-hosted gateway with SDK, CLI, MCP and HTTP access. + +## Overview + +[open-connector](https://github.com/oomol-lab/open-connector) is an open-source gateway connecting 1000+ SaaS providers to AI agents via SDK, CLI, MCP and HTTP. Eden AI ships as a **built-in connector**, so any agent wired through open-connector reaches models from OpenAI, Anthropic, Google, Mistral and more behind one key, with EU-based, GDPR-aligned inference and per-request cost visibility. + +## Installation + +open-connector is a self-hosted gateway, distributed as a Docker image: + + +```bash Docker +docker compose up +``` + + +This pulls `ghcr.io/oomol-lab/open-connector:latest` and serves the console and API at `http://localhost:3000`. + +## Quick Start + +Store your Eden AI key as a connection credential, then call the `edenai` service: + + +```bash Add credential +curl -s -X PUT http://localhost:3000/api/connections/edenai \ + -H 'content-type: application/json' \ + -d '{"authType":"api_key","values":{"apiKey":"your_api_key_here"}}' +``` + +```bash Call Eden AI +curl -s -X POST http://localhost:3000/v1/actions/edenai.create_chat_completion \ + -H 'content-type: application/json' \ + -d '{ + "input": { + "model": "openai/gpt-5.5", + "messages": [{"role": "user", "content": "Hello! How are you?"}] + } + }' +``` + + +The base URL (`https://api.edenai.run/v3`) is built into the connector — no extra configuration needed. The response includes the standard OpenAI-compatible fields plus a top-level `cost` field with the Eden AI billed cost. + +## Available Models + +The `edenai` service exposes `edenai.list_models` and `edenai.create_chat_completion`. Use the `provider/model` format for any Eden AI model: + +**OpenAI** +- `openai/gpt-5.5` +- `openai/gpt-5-mini` + +**Anthropic** +- `anthropic/claude-sonnet-5` +- `anthropic/claude-haiku-4-5` + +**Google** +- `google/gemini-2.5-pro` +- `google/gemini-3.5-flash` + +**Mistral** +- `mistral/mistral-large-2512` +- `mistral/mistral-small-2603` + +## Credentials + +Unlike most integrations, open-connector stores the Eden AI key as a **connection credential** through its API rather than an environment variable: + + +```bash Update credential +curl -s -X PUT http://localhost:3000/api/connections/edenai \ + -H 'content-type: application/json' \ + -d '{"authType":"api_key","values":{"apiKey":"your_api_key_here"}}' +``` + + +## Next Steps + +- [Lynkr](/v3/integrations/lynkr) - Another self-hosted LLM gateway +- [Bifrost](/v3/integrations/bifrost) - Custom-provider LLM gateway +- [Chat Completions](/v3/llms/chat-completions) - Core LLM endpoint