> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nordlyslabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zed Editor Integration

> Configure Zed Editor with Nordlys's Mixture of Models model for lab-grade coding quality and lower cost

Configure Zed Editor to use Nordlys's Mixture of Models model for high-quality AI-assisted coding.

<Tip>
  **Get the best AI specialist for every prompt** with a Mixture of Models model. Works as an OpenAI-compatible provider in Zed Editor.
</Tip>

## Get Your Nordlys API Key

[Sign up here](https://nordlyslabs.com/api-platform/orgs) to create an account and generate your API key.

## Quick Setup

<Steps>
  <Step title="Run Automated Installer" icon="rocket">
    <CodeGroup>
      ```bash macOS/Linux theme={null}
      curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/zed.sh | bash
      ```

      ```powershell Windows (PowerShell) theme={null}
      iwr -useb https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/zed.ps1 | iex
      ```
    </CodeGroup>

    The installer will automatically:

    * Check if Zed is installed
    * Configure OpenAI-compatible provider with Nordlys
    * Backup existing settings
    * Add environment variables to your shell profile
  </Step>

  <Step title="Restart Zed Editor" icon="refresh">
    Close and restart Zed Editor to load the new configuration.
  </Step>

  <Step title="Open Agent Panel" icon="robot">
    Open the Agent Panel using:

    * **macOS**: `Cmd + Shift + A`
    * **Windows/Linux**: `Ctrl + Shift + A`

    Or via Command Palette: `agent: toggle`
  </Step>

  <Step title="Select Nordlys Model" icon="check">
    In the Agent Panel:

    1. Click the model dropdown
    2. Look for **"Nordlys"** section
    3. Select **"Hypernova"**

    You're now using Nordlys Mixture of Models!
  </Step>
</Steps>

## Manual Installation

If you prefer to configure Zed manually:

### Step 1: Locate Settings File

<CodeGroup>
  ```bash macOS/Linux theme={null}
  ~/.config/zed/settings.json
  ```

  ```powershell Windows theme={null}
  %APPDATA%\Zed\settings.json
  ```
</CodeGroup>

### Step 2: Add Nordlys Configuration

Open your `settings.json` and add the Nordlys provider configuration:

```json theme={null}
{
  "language_models": {
    "openai_compatible": {
      "Nordlys": {
        "api_url": "https://api.nordlyslabs.com/v1",
        "available_models": [
          {
            "name": "nordlys/hypernova",
            "display_name": "Hypernova",
            "max_tokens": 200000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": true,
              "prompt_cache_key": false
            }
          }
        ]
      }
    }
  },
  "agent": {
    "default_model": {
      "provider": "openai_compatible",
      "model": "nordlys/hypernova",
      "name": "Nordlys"
    }
  }
}
```

### Step 3: Set API Key

Add your Nordlys API key as an environment variable:

<CodeGroup>
  ```bash macOS/Linux (.bashrc or .zshrc) theme={null}
  export NORDLYS_API_KEY="your-api-key-here"
  ```

  ```powershell Windows (PowerShell) theme={null}
  $env:NORDLYS_API_KEY="your-api-key-here"
  setx NORDLYS_API_KEY "your-api-key-here"
  ```
</CodeGroup>

Restart your terminal and Zed Editor.

## Alternative Setup Methods

<CodeGroup>
  ```bash Environment Variables (Unix) theme={null}
  export NORDLYS_API_KEY='your-api-key-here'
  curl -fsSL https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/zed.sh | bash
  ```

  ```powershell Environment Variables (PowerShell) theme={null}
  $env:NORDLYS_API_KEY="your-api-key-here"
  setx NORDLYS_API_KEY "your-api-key-here"
  iwr -useb https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/windows/zed.ps1 | iex
  ```

  ```bash Interactive Install (Unix) theme={null}
  curl -o zed.sh https://raw.githubusercontent.com/Nordlys-Labs/nordlys/main/scripts/installers/unix/zed.sh
  chmod +x zed.sh
  ./zed.sh
  ```
</CodeGroup>

## Features with Nordlys

<CardGroup cols={2}>
  <Card title="Mixture of Models" icon="brain">
    The right specialists activate per prompt for optimal results
  </Card>

  <Card title="Cost Optimization" icon="trending-down">
    Intelligent model selection for better value and performance
  </Card>

  <Card title="Tool Support" icon="wrench">
    Full support for function calling and tool use
  </Card>

  <Card title="Vision Capabilities" icon="image">
    Process and analyze images in your conversations
  </Card>
</CardGroup>

## Agent Panel Profiles

Zed's Agent Panel supports different interaction profiles:

* **Ask**: Query-focused interactions for quick questions
* **Write**: Generate code, documentation, and content
* **Minimal**: Lightweight interactions with minimal context

All profiles work seamlessly with Nordlys models.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Model Not Appearing in Dropdown" icon="eye-slash">
    * Verify `settings.json` syntax is valid (check for missing commas, brackets)
    * Ensure Zed has been fully restarted after configuration
    * Check that the `language_models` section is at the root level of your JSON
    * Review Zed's log output: `zed: open log`
  </Accordion>

  <Accordion title="Authentication Errors" icon="key">
    * Verify your API key at [nordlyslabs.com/api-platform/orgs](https://nordlyslabs.com/api-platform/orgs)
    * Ensure `NORDLYS_API_KEY` environment variable is set
    * Restart your terminal and Zed after setting the environment variable
    * Check the environment variable is loaded: `echo $NORDLYS_API_KEY` (Unix) or `$env:NORDLYS_API_KEY` (PowerShell)
  </Accordion>

  <Accordion title="Connection Issues" icon="wifi-off">
    * Check that `api_url` is set to `https://api.nordlyslabs.com/v1`
    * Verify network connectivity to api.nordlyslabs.com
    * Check for proxy settings that might interfere
    * Review error messages in Zed's log: `zed: open log`
  </Accordion>

  <Accordion title="Installation Issues" icon="download">
    * Ensure Zed is installed: visit [zed.dev](https://zed.dev)
    * Check that Python 3 is available (required by installer)
    * Manually backup your settings before running the installer
    * Try manual configuration if the installer fails
  </Accordion>
</AccordionGroup>

## Advanced Configuration

### Custom Model Parameters

You can customize model parameters by modifying the `available_models` section:

```json theme={null}
{
  "language_models": {
    "openai_compatible": {
      "Nordlys": {
        "api_url": "https://api.nordlyslabs.com/v1",
        "available_models": [
          {
            "name": "nordlys/hypernova",
            "display_name": "Hypernova (Custom)",
            "max_tokens": 200000,
            "max_output_tokens": 8192,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": true
            }
          }
        ]
      }
    }
  }
}
```

### Multiple Provider Configuration

You can configure multiple OpenAI-compatible providers:

```json theme={null}
{
  "language_models": {
    "openai_compatible": {
      "Nordlys": {
        "api_url": "https://api.nordlyslabs.com/v1",
        "available_models": [/* ... */]
      },
      "Another Provider": {
        "api_url": "https://api.example.com/v1",
        "available_models": [/* ... */]
      }
    }
  }
}
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Monitor Usage & Savings" href="https://nordlyslabs.com/api-platform/orgs" icon="chart-line" cta="View Dashboard">
    Track your cost savings and usage analytics in real-time
  </Card>

  <Card title="API Documentation" href="/api-reference/chat-completions" icon="book" cta="View API Docs">
    Learn about Nordlys's API capabilities and advanced features
  </Card>

  <Card title="Other Dev Tools" href="/developer-tools/cursor" icon="code" cta="More Tools">
    Explore other AI development tools with Nordlys integration
  </Card>

  <Card title="Get Support" href="/troubleshooting" icon="life-ring" cta="Get Help">
    Troubleshooting guides and support resources
  </Card>
</CardGroup>

***

<Note>
  **Was this page helpful?** Contact us at [info@llmadaptive.uk](mailto:info@llmadaptive.uk) for feedback or assistance with your Zed integration.
</Note>