Skip to content
Open
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
19 changes: 18 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Step-by-step guides for connecting [Eden AI](https://www.edenai.co/) to the tools, agents, and platforms you already use.

Each guide walks through installation, configuration, and model selection so you can route your workflow through **500+ LLMs and AI models** with a single API key — with smart routing, automatic fallbacks, unified billing, and per-request cost visibility.
Each guide walks through installation, configuration, and model selection so you can route your workflow through **700+ LLMs and AI models** with a single API key — with smart routing, automatic fallbacks, unified billing, and per-request cost visibility.

> Don't have a key yet? Sign up at [app.edenai.run](https://app.edenai.run/) → **API Keys**.

Expand All @@ -16,6 +16,23 @@ Each guide walks through installation, configuration, and model selection so you
| OpenCode | [opencode.md](./opencode.md) | [YouTube](https://youtu.be/OYHRY5rblz0) | [edenai.co/integrations/opencode](https://www.edenai.co/integrations/opencode) |
| Cline | [cline.md](./cline.md) | [YouTube](https://youtu.be/_M8PwHSwgMQ) | [edenai.co/integrations/cline](https://www.edenai.co/integrations/cline) |

## Coding agents (terminal & IDE)

Connect any of the leading open-source coding agents to Eden AI. All use the OpenAI-compatible endpoint `https://api.edenai.run/v3` with `provider/model` naming.

| Tool | Guide | Video | Mechanism |
|---|---|---|---|
| OpenCode | [opencode.md](./opencode.md) | [YouTube](https://youtu.be/OYHRY5rblz0) | Custom provider (`opencode.json`) |
| Codex CLI | [codex-cli.md](./codex-cli.md) | [YouTube](https://youtu.be/sVLPbencnnM) | `config.toml` provider (`wire_api = "responses"`) |
| OpenHands | [openhands.md](./openhands.md) | — | LiteLLM (OpenAI-compatible) |
| Cline | [cline.md](./cline.md) | [YouTube](https://youtu.be/_M8PwHSwgMQ) | Built-in Eden AI provider |
| Pi | [pi.md](./pi.md) | — | Custom provider (`~/.pi/agent/models.json`) |
| Goose | [goose.md](./goose.md) | — | Custom provider / env |
| Aider | [aider.md](./aider.md) | — | OpenAI-compatible / LiteLLM |
| Continue | [continue.md](./continue.md) | — | Custom provider (`config.yaml`) |
| Qwen Code | [qwen-code.md](./qwen-code.md) | — | Env (`OPENAI_BASE_URL`) |
| Crush | [crush.md](./crush.md) | — | Custom provider (`crush.json`) |

More integrations are added regularly. Open an issue if there's a tool you'd like us to cover.

---
Expand Down
95 changes: 95 additions & 0 deletions aider.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
# Aider + Eden AI

Connect [Aider](https://aider.chat) to Eden AI and route the original terminal AI pair programmer through **700+ models** with smart routing, automatic fallbacks, and a single API key.

> Get your Eden AI key at [app.edenai.run](https://app.edenai.run/) → **API Keys**.

---

## 1. System dependencies

On a fresh Linux machine (Ubuntu / Debian / WSL):

```bash
sudo apt update
sudo apt install -y curl git python3 python3-venv
```

## 2. Install Aider

```bash
# Recommended — isolated install via uv
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install aider-chat

# Or via pip
python3 -m pip install aider-install && aider-install

# Verify
aider --version
```

## 3. Point Aider at Eden AI

Aider connects to any OpenAI-compatible endpoint. Export the base URL and your key:

```bash
export OPENAI_API_BASE="https://api.edenai.run/v3"
export OPENAI_API_KEY="YOUR_EDEN_AI_API_KEY"
```

## 4. Run Aider

Aider runs on top of LiteLLM, so prefix the Eden AI model with `openai/` (this selects the OpenAI-compatible driver; it is stripped before the request):

```bash
# Fast and cheap
aider --model openai/openai/gpt-4o-mini

# Claude via Eden AI
aider --model openai/anthropic/claude-haiku-4-5
```

Every edit now flows through Eden AI — with built-in fallbacks, unified billing, and per-request cost visibility.

---

## Using specific models

The model string is `openai/<eden-provider>/<eden-model>`:

| Aider `--model` value | Best for |
|---|---|
| `openai/openai/gpt-4o-mini` | Fast and cheap |
| `openai/anthropic/claude-sonnet-4-5` | Balanced reasoning |
| `openai/anthropic/claude-opus-4-7` | Maximum capability |
| `openai/openai/gpt-5` | OpenAI's frontier model |
| `openai/google/gemini-2.5-pro` | Long context, multimodal |

> **Note.** Use a concrete `provider/model` with Aider. The smart-router alias `@edenai` is not recommended here — LiteLLM rejects some routed reasoning-model parameters.

## Troubleshooting

### `401 Unauthorized`
Verify your Eden AI key — grab a fresh one at [app.edenai.run → API Keys](https://app.edenai.run/). Confirm `OPENAI_API_KEY` and `OPENAI_API_BASE` are exported in the same shell.

### `NotFoundError` / `model not found`
Keep the double prefix: `openai/` + the Eden AI `provider/model` (e.g. `openai/anthropic/claude-haiku-4-5`).

### `BadRequestError: Unsupported value`
You're likely targeting a reasoning model or the `@edenai` router. Switch to a concrete chat model such as `openai/openai/gpt-4o-mini`.

## Uninstall

```bash
uv tool uninstall aider-chat # or: pip uninstall aider-chat
```

---

## Next steps

- [Smart routing](https://www.edenai.co/docs/v3/llms/smart-routing)
- [Fallbacks](https://www.edenai.co/docs/v3/llms/fallback)
- [Eden AI pricing](https://www.edenai.co/pricing)
- [Aider docs](https://aider.chat/docs/)
118 changes: 118 additions & 0 deletions codex-cli.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,118 @@
# Codex CLI + Eden AI

Connect [OpenAI Codex CLI](https://github.com/openai/codex) to Eden AI and route your terminal agent through **700+ models** with smart routing, automatic fallbacks, and a single API key.

> Get your Eden AI key at [app.edenai.run](https://app.edenai.run/) → **API Keys**.

Follow this tuto in the same time with our video tuto on [Youtube](https://youtu.be/sVLPbencnnM)

---

## 1. System dependencies

On a fresh Linux machine (Ubuntu / Debian / WSL):

```bash
sudo apt update
sudo apt install -y curl git
```

## 2. Install Codex CLI

```bash
# Option A — via npm
npm install -g @openai/codex

# Option B — via Homebrew (macOS / Linuxbrew)
brew install codex

# Verify
codex --version
```

## 3. Add Eden AI as a custom provider

Codex stores its config at `~/.codex/config.toml`. Add Eden AI as a model provider:

```bash
mkdir -p ~/.codex
nano ~/.codex/config.toml
```

```toml
model = "openai/gpt-4o-mini"
model_provider = "edenai"

[model_providers.edenai]
name = "Eden AI"
base_url = "https://api.edenai.run/v3"
env_key = "EDENAI_API_KEY"
wire_api = "responses"
```

Export your key so Codex can read it:

```bash
export EDENAI_API_KEY="YOUR_EDEN_AI_API_KEY"
```

> **`wire_api = "responses"` is required.** Recent Codex CLI (≥ 0.122) removed support for `wire_api = "chat"`. Eden AI implements the OpenAI **Responses API** (`/v3/responses`), so Codex connects directly — no proxy needed. The provider ids `openai`, `ollama`, `lmstudio` are reserved, so keep the id `edenai`.

## 4. Run Codex

Interactive:

```bash
codex
```

Non-interactive (one-shot):

```bash
codex exec "Refactor this function and add tests"
```

Every LLM call now flows through Eden AI — with built-in fallbacks, unified billing, and per-request cost visibility.

---

## Using specific models

Switch model by editing `model` in `config.toml`, keyed by `provider/model`:

| Model | Best for |
|---|---|
| `openai/gpt-4o-mini` | Fast and cheap (default above) |
| `anthropic/claude-sonnet-4-5` | Balanced reasoning |
| `anthropic/claude-opus-4-7` | Maximum capability |
| `openai/gpt-5` | OpenAI's frontier model |
| `google/gemini-2.5-pro` | Long context, multimodal |

> Eden AI's smart router `@edenai` also works over the Responses API. If you use it, expect Codex to route to a reasoning-grade model automatically.

## Troubleshooting

### `wire_api = "chat" is no longer supported`
Set `wire_api = "responses"` in your provider config (see step 3).

### `401 Unauthorized`
Verify your Eden AI key — grab a fresh one at [app.edenai.run → API Keys](https://app.edenai.run/). Confirm `EDENAI_API_KEY` is exported in the same shell.

### `model not found`
Use the `provider/model` format (e.g. `openai/gpt-4o-mini`). No bare model names.

## Uninstall

```bash
npm uninstall -g @openai/codex
rm -rf ~/.codex
```

---

## Next steps

- [Smart routing](https://www.edenai.co/docs/v3/llms/smart-routing)
- [Fallbacks](https://www.edenai.co/docs/v3/llms/fallback)
- [Eden AI pricing](https://www.edenai.co/pricing)
- [Codex CLI GitHub](https://github.com/openai/codex)
86 changes: 86 additions & 0 deletions continue.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
# Continue + Eden AI

Connect [Continue](https://continue.dev) to Eden AI and route the `cn` agent (and the IDE extension) through **700+ models** with smart routing, automatic fallbacks, and a single API key.

> Get your Eden AI key at [app.edenai.run](https://app.edenai.run/) → **API Keys**.

---

## 1. Install Continue

- **IDE:** install the **Continue** extension from the VS Code or JetBrains marketplace.
- **CLI:** install the `cn` terminal agent:

```bash
npm install -g @continuedev/cli
cn --version
```

## 2. Add Eden AI in `config.yaml`

Continue reads `~/.continue/config.yaml`. Add Eden AI as an OpenAI-compatible provider:

```bash
nano ~/.continue/config.yaml
```

```yaml
models:
- name: GPT-4o mini (Eden AI)
provider: openai
model: openai/gpt-4o-mini
apiBase: https://api.edenai.run/v3
apiKey: YOUR_EDEN_AI_API_KEY
roles:
- chat
- edit
- name: Claude Haiku 4.5 (Eden AI)
provider: openai
model: anthropic/claude-haiku-4-5
apiBase: https://api.edenai.run/v3
apiKey: YOUR_EDEN_AI_API_KEY
roles:
- chat
- edit
```

> `provider: openai` selects the OpenAI-compatible driver; `apiBase` points it at Eden AI. Model ids use the `provider/model` format.

## 3. Run

Reload your IDE (or start `cn`) and pick an **Eden AI** model from the model selector. Every LLM call now flows through Eden AI — with built-in fallbacks, unified billing, and per-request cost visibility.

---

## Using specific models

Add more entries under `models`, keyed by `provider/model`:

| `model` | Best for |
|---|---|
| `openai/gpt-4o-mini` | Fast and cheap |
| `anthropic/claude-sonnet-4-5` | Balanced reasoning |
| `anthropic/claude-opus-4-7` | Maximum capability |
| `openai/gpt-5` | OpenAI's frontier model |
| `google/gemini-2.5-pro` | Long context, multimodal |

## Troubleshooting

### `401 Unauthorized`
Verify your Eden AI key at [app.edenai.run → API Keys](https://app.edenai.run/).

### `model not found`
Use the `provider/model` format for `model`, and set `apiBase` to exactly `https://api.edenai.run/v3`.

## Uninstall

Remove the Continue extension from your IDE, or `npm uninstall -g @continuedev/cli`, then delete `~/.continue`.

---

## Next steps

- [Smart routing](https://www.edenai.co/docs/v3/llms/smart-routing)
- [Fallbacks](https://www.edenai.co/docs/v3/llms/fallback)
- [Eden AI pricing](https://www.edenai.co/pricing)
- [Continue docs](https://docs.continue.dev/)
Loading
Loading