Skip to content

docs: add Altimate LLM Gateway provider, expand IDE page, update quic… #607

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.

Sign up for GitHub

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
arora-saurabh448 merged 5 commits into from
Apr 4, 2026
+67 −20
Merged

docs: add Altimate LLM Gateway provider, expand IDE page, update quic… #607

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
1bc4550
docs: add Altimate LLM Gateway provider, expand IDE page, update quic…
Apr 1, 2026
c30ecbe
docs: fix ZDR wording, add CLI prerequisite, add Windsurf to IDE page
Apr 2, 2026
875f4c1
docs: strip gateway data handling details from providers.md
Apr 2, 2026
e412047
Merge branch 'main' into docs/altimate-code-llm-gateway
arora-saurabh448 Apr 2, 2026
9d7c76b
Merge branch 'main' into docs/altimate-code-llm-gateway
arora-saurabh448 Apr 4, 2026
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
22 changes: 22 additions & 0 deletions docs/docs/configure/providers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,28 @@ Each provider has a key in the `provider` object:
!!! tip
Use `{env:...}` substitution for API keys so you never commit secrets to version control.

## Altimate LLM Gateway

Managed LLM access with dynamic routing across Sonnet 4.6, Opus 4.6, GPT-5.4, GPT-5.3, and more. No API keys to manage — 10M tokens free to get started.

```json
{
"provider": {
"altimate": {}
},
"model": "altimate/auto"
}
```

The gateway dynamically routes each request to the best model for the task. You pay a flat token price regardless of which model handles your request.

- Zero data retention — prompts and responses are never stored
- Uses Azure Foundry and AWS Bedrock as subprocessors with ZDR
- BYOK is always free and unlimited alongside the gateway
- Stores only metadata (token counts, latency) to improve model ranking and routing

For full pricing tiers and details, see the [Altimate LLM Gateway guide](https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/).
Copy link
Copy Markdown

@coderabbitai coderabbitai bot Apr 2, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Description: Verify external documentation links return 200 OK

echo "=== Checking Altimate LLM Gateway documentation link ==="
curl -s -o /dev/null -w "HTTP Status: %{http_code}\nURL: %{url_effective}\n" \
  -L "https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/"

Repository: AltimateAI/altimate-code

Length of output: 219

The external documentation link returns HTTP 404 and must be fixed before merge.

The link to https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/ is broken. Either update it to a working URL or remove the reference if the documentation does not exist.

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@docs/docs/configure/providers.md` at line 45, The external docs link
"https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/" in
the markdown line "For full pricing tiers and details, see the [Altimate LLM
Gateway
guide](https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/)."
is returning 404; either replace that URL with the correct working documentation
URL or remove the entire sentence if the guide doesn't exist. Locate the exact
Markdown line containing the Altimate LLM Gateway guide link and update the href
to a valid page (or delete the reference) and run a quick link-check to ensure
no other broken links remain.


## Anthropic

```json
Expand Down
3 changes: 2 additions & 1 deletion docs/docs/develop/ecosystem.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,8 @@ altimate has a growing ecosystem of plugins, tools, and integrations.

- **GitHub Actions**: Automated PR review and issue triage
- **GitLab CI**: Merge request analysis
- **VS Code / Cursor**: IDE integration
- **VS Code / Cursor / Windsurf**: [IDE integration](../usage/ide.md) via the Datamates extension
- **[Datamates](https://datamates-docs.myaltimate.com/)**: AI teammates platform with MCP integrations, Knowledge Hub, Memory, and Guardrails
- **MCP**: Model Context Protocol servers
- **ACP**: Agent Communication Protocol for editors

Expand Down
3 changes: 3 additions & 0 deletions docs/docs/getting-started/quickstart-new.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,9 @@ export ANTHROPIC_API_KEY=sk-ant-...
altimate
```

!!! tip "Don't want to manage API keys?"
The [Altimate LLM Gateway](https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/) gives you 10M tokens free — no API keys needed. It dynamically routes to the best model for each task across Sonnet 4.6, Opus 4.6, GPT-5.4, and more.

Copy link
Copy Markdown

@StevenAltimate StevenAltimate Apr 2, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a suggestion, but we could make it so this is a tabbed table showing how to add their own key or setting up through the LLM gateway here. Ignore if you think that's too much.

---

## Step 3: Connect Your Warehouse
Expand Down
53 changes: 35 additions & 18 deletions docs/docs/usage/ide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,28 +1,45 @@
# IDE

altimate integrates with VS Code and Cursor as an AI assistant.
altimate-code integrates with your IDE via the [Datamates extension](https://marketplace.visualstudio.com/items?itemName=altimateai.vscode-altimate-mcp-server), giving you AI-powered chat with 100+ data engineering tools directly in your editor.

!!! warning "Beta"
IDE integration is currently in beta. Features may change.
---

## VS Code / Cursor
## Install the Extension

### Setup
Install the Datamates extension for your IDE:

1. Install the altimate extension from the marketplace
2. Ensure `altimate` is installed globally:
```bash
npm install -g altimate-code
```
3. The extension will auto-detect the CLI
- **VS Code** — [Microsoft Marketplace](https://marketplace.visualstudio.com/items?itemName=altimateai.vscode-altimate-mcp-server)
- **Cursor / other VS Code-compatible editors** — [Open VSX Registry](https://open-vsx.org/extension/altimateai/vscode-altimate-mcp-server)
Comment on lines +21 to +22
Copy link
Copy Markdown

@coderabbitai coderabbitai bot Apr 2, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Description: Verify all external documentation and marketplace links return 200 OK

echo "=== Verifying VS Code Marketplace link ==="
curl -s -o /dev/null -w "HTTP Status: %{http_code}\nURL: %{url_effective}\n\n" \
  -L "https://marketplace.visualstudio.com/items?itemName=altimateai.vscode-altimate-mcp-server"

echo "=== Verifying Open VSX Registry link ==="
curl -s -o /dev/null -w "HTTP Status: %{http_code}\nURL: %{url_effective}\n\n" \
  -L "https://open-vsx.org/extension/altimateai/vscode-altimate-mcp-server"

echo "=== Verifying Altimate LLM Gateway documentation ==="
curl -s -o /dev/null -w "HTTP Status: %{http_code}\nURL: %{url_effective}\n\n" \
  -L "https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/"

echo "=== Verifying Datamates documentation root ==="
curl -s -o /dev/null -w "HTTP Status: %{http_code}\nURL: %{url_effective}\n\n" \
  -L "https://datamates-docs.myaltimate.com/"

Repository: AltimateAI/altimate-code

Length of output: 614

Fix broken external documentation link at line 52.

The LLM Gateway documentation link returns HTTP 404:

  • https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/ — page not found

Verify the correct URL and update the link. The VS Code Marketplace (line 21), Open VSX Registry (line 22), and Datamates root (line 56) are accessible.

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@docs/docs/usage/ide.md` around lines 21 - 22, The LLM Gateway external link
is returning 404; locate the LLM Gateway link entry (the markdown anchor for
"LLM Gateway") and update its URL to the correct, live Datamates docs page
(replace the broken
https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/ with
the verified canonical URL), then verify the updated link loads successfully in
a browser; ensure surrounding links (the VS Code and Open VSX entries shown in
the diff) remain unchanged.


### Features
## Open Altimate Code Chat

- Inline chat with altimate agents
- File context awareness from your editor
- Tool call results displayed inline
- Agent mode switching from the command palette
After installing the extension:

### Configuration
1. Press `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows/Linux) to open the command palette
2. Type `Datamates`
3. Select **Datamates: Open Altimate Code Chat**
Copy link
Copy Markdown

@StevenAltimate StevenAltimate Apr 2, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Piece of media here would be great. Maybe just a picture of the panel being open?


The extension uses your existing `altimate-code.json` config. No additional IDE configuration is required.
This opens the Altimate Code chat panel where you can interact with altimate agents and use all 100+ data engineering tools.

## Features

- **Inline chat** with altimate agents — ask questions, run tools, and get results directly in your editor
- **File context awareness** — the agent sees your open files and project structure
- **Tool call results inline** — SQL analysis, lineage, dbt operations, and more displayed in the chat
- **Agent mode switching** — switch between Builder (full read/write), Analyst (read-only), and Plan (minimal access) modes from the command palette
- **100+ data engineering tools** — SQL validation, query optimization, column lineage, dbt model generation, FinOps analysis, schema exploration, and more

## Configuration

The extension uses your existing `altimate-code.json` config. No additional IDE-specific configuration is required. Warehouse connections, LLM providers, permissions, and agent settings all carry over.

## LLM Access

You need an LLM to power the chat. Two options:

- **BYOK (Bring Your Own Key)** — Free and unlimited. Configure any of the [35+ supported providers](../configure/providers.md) (Anthropic, OpenAI, AWS Bedrock, Azure OpenAI, etc.)
- **[Altimate LLM Gateway](https://datamates-docs.myaltimate.com/user-guide/components/llm-gateway/)** — Managed LLM access with dynamic model routing. 10M tokens free to get started — no API keys to manage

## Full Datamates Documentation

The Datamates extension offers additional capabilities beyond Altimate Code Chat, including MCP server integrations, Knowledge Hub, Memory Hub, and Guardrails. See the [Datamates documentation](https://datamates-docs.myaltimate.com/) for full setup guides, integration configuration, and feature details.
Loading