-
Notifications
You must be signed in to change notification settings - Fork 1
docs: add Eden AI integration guide for aisuite #76
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,146 @@ | ||
| --- | ||
| title: "aisuite" | ||
| icon: "/integration-logo/aisuite-icondoc.svg" | ||
| description: "Use aisuite with Eden AI to call 500+ AI models through one unified, OpenAI-style interface." | ||
| --- | ||
|
|
||
| import { TechArticleSchema } from "/snippets/TechArticleSchema.mdx"; | ||
|
|
||
| <TechArticleSchema | ||
| title={"aisuite"} | ||
| description={"Use aisuite with Eden AI to call 500+ AI models through one unified, OpenAI-style interface."} | ||
| path="v3/integrations/aisuite" | ||
| articleSection="AI Frameworks" | ||
| about={"LLM Framework Integration"} | ||
| proficiencyLevel="Intermediate" | ||
| keywords={["Eden AI", "AI API", "aisuite", "Python", "Andrew Ng"]} | ||
| datePublished="2026-07-17T00:00:00Z" | ||
| dateModified="2026-07-17T00:00:00Z" | ||
| /> | ||
|
|
||
| Use aisuite with Eden AI to call 500+ AI models through one unified, OpenAI-style interface. | ||
|
|
||
| ## Overview | ||
|
|
||
| [aisuite](https://github.com/andrewyng/aisuite) is a lightweight Python library (from Andrew Ng's team) that gives you a single, OpenAI-style Chat Completions interface across many providers — swap providers by changing one string. **Eden AI is a built-in aisuite provider**, so you reach models from OpenAI, Anthropic, Google, Mistral, Cohere, Meta and more behind one key, with EU-based, GDPR-aligned inference. | ||
|
Check warning on line 25 in v3/integrations/aisuite.mdx
|
||
|
|
||
| You select a model with the `provider:model_id` syntax. For Eden AI, the provider is `edenai` and the model id follows Eden AI's `provider/model` scheme — for example `edenai:anthropic/claude-sonnet-5`. | ||
|
|
||
| ## Installation | ||
|
|
||
| Eden AI is OpenAI-compatible, so aisuite talks to it through the `openai` SDK — install both: | ||
|
|
||
| <CodeGroup> | ||
| ```bash pip | ||
| pip install aisuite openai | ||
| ``` | ||
|
|
||
| ```bash poetry | ||
| poetry add aisuite openai | ||
| ``` | ||
| </CodeGroup> | ||
|
|
||
| ## Quick Start | ||
|
|
||
| Set your key, then point aisuite at Eden AI by prefixing any model with `edenai:`: | ||
|
|
||
| <CodeGroup> | ||
| ```bash .env | ||
| EDENAI_API_KEY=your_api_key_here | ||
| ``` | ||
|
|
||
| {/* skip-test */} | ||
| ```python Python | ||
| import aisuite as ai | ||
|
|
||
| client = ai.Client() | ||
|
|
||
| response = client.chat.completions.create( | ||
| model="edenai:anthropic/claude-sonnet-5", # edenai:<provider>/<model> | ||
| messages=[ | ||
| {"role": "system", "content": "You are a helpful assistant."}, | ||
| {"role": "user", "content": "Hello! How are you?"}, | ||
| ], | ||
| ) | ||
|
|
||
| print(response.choices[0].message.content) | ||
| ``` | ||
| </CodeGroup> | ||
|
|
||
| The `edenai` provider automatically uses the Eden AI base URL (`https://api.edenai.run/v3`) and reads your key from the `EDENAI_API_KEY` environment variable. | ||
|
|
||
| ## Switching models | ||
|
|
||
| aisuite's core benefit: change providers by changing one string. Every Eden AI model is reachable the same way — no per-provider SDKs, no code changes: | ||
|
Check warning on line 74 in v3/integrations/aisuite.mdx
|
||
|
|
||
| <CodeGroup> | ||
| {/* skip-test */} | ||
| ```python Python | ||
| import aisuite as ai | ||
|
|
||
| client = ai.Client() | ||
| messages = [{"role": "user", "content": "Write a haiku about the sea."}] | ||
|
|
||
| for model in [ | ||
| "edenai:openai/gpt-5.5", | ||
| "edenai:anthropic/claude-sonnet-5", | ||
| "edenai:mistral/mistral-large-2512", | ||
| ]: | ||
| response = client.chat.completions.create(model=model, messages=messages) | ||
| print(model, "->", response.choices[0].message.content) | ||
| ``` | ||
| </CodeGroup> | ||
|
|
||
| ## Available Models | ||
|
|
||
| Use the `edenai:<provider>/<model>` format for any Eden AI model: | ||
|
|
||
| **OpenAI** | ||
| - `edenai:openai/gpt-5.5` | ||
| - `edenai:openai/gpt-5-mini` | ||
|
|
||
| **Anthropic** | ||
| - `edenai:anthropic/claude-sonnet-5` | ||
| - `edenai:anthropic/claude-opus-4-8` | ||
| - `edenai:anthropic/claude-haiku-4-5` | ||
|
|
||
| **Google** | ||
| - `edenai:google/gemini-2.5-pro` | ||
| - `edenai:google/gemini-3.5-flash` | ||
|
|
||
| **Mistral** | ||
| - `edenai:mistral/mistral-large-2512` | ||
| - `edenai:mistral/mistral-small-2603` | ||
|
|
||
| ## Passing configuration explicitly | ||
|
|
||
| Prefer not to use environment variables? Pass the key through the aisuite client config instead: | ||
|
|
||
| <CodeGroup> | ||
| {/* skip-test */} | ||
| ```python Python | ||
| import aisuite as ai | ||
|
|
||
| client = ai.Client({"edenai": {"api_key": "YOUR_EDENAI_API_KEY"}}) | ||
|
|
||
| response = client.chat.completions.create( | ||
| model="edenai:mistral/mistral-large-2512", | ||
| messages=[{"role": "user", "content": "Say hello in French."}], | ||
| ) | ||
| print(response.choices[0].message.content) | ||
| ``` | ||
| </CodeGroup> | ||
|
|
||
| ## Environment Variables | ||
|
|
||
| <CodeGroup> | ||
| ```bash .env | ||
| EDENAI_API_KEY=your_api_key_here | ||
| ``` | ||
| </CodeGroup> | ||
|
|
||
| ## Next Steps | ||
|
|
||
| - [Chat Completions](/v3/llms/chat-completions) - Core LLM endpoint | ||
| - [List LLM Models](/v3/llms/listing-models) - Browse available providers and models | ||
| - [OpenAI SDK (Python)](/v3/integrations/openai-sdk-python) - Direct SDK usage | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win
Use standard token type placeholders.
As per coding guidelines, code examples must distinguish token types by using
api_tokenfor production keys (orsandbox_api_tokenfor testing), rather than custom placeholders likeyour_api_key_hereorYOUR_EDENAI_API_KEY.v3/integrations/aisuite.mdx#L49-L49: Replaceyour_api_key_herewithapi_token.v3/integrations/aisuite.mdx#L124-L124: ReplaceYOUR_EDENAI_API_KEYwithapi_token.v3/integrations/aisuite.mdx#L138-L138: Replaceyour_api_key_herewithapi_token.📍 Affects 1 file
v3/integrations/aisuite.mdx#L49-L49(this comment)v3/integrations/aisuite.mdx#L124-L124v3/integrations/aisuite.mdx#L138-L138🤖 Prompt for AI Agents
Source: Coding guidelines