🚀 Quick Start: LibreChat & Zed IDE

Get both interfaces running in 15 minutes.

Prerequisites

1. Start SEA™ Services (5 min)

1
2
3
4
5
6
7
8
9
10
11
12
cd /path/to/SEA™

# First time? Run audit and setup
just ui-audit      # Check prerequisites
just ui-setup      # Configure everything (idempotent)
just ui-setup-dry  # Preview what setup would do

# Start all services
just ui-up

# Verify health
just ui-status

Expected Output

1
2
3
4
5
✅ UI services running!

   LibreChat:  http://localhost:3080
   SEA™ API:    http://localhost:8080
   API Docs:   http://localhost:8080/docs

Just Recipes Reference

2. Configure LibreChat (2 min)

Copy the provided configuration:

1
cp deploy/librechat/librechat.yaml ~/.librechat/librechat.yaml

Set API key:

1
export SEA_API_KEY=your-generated-key

Access LibreChat at: http://localhost:3080

Your First Chat

1
2
3
4
5
6
7
8
You: What SEA™ capabilities are available?

SEA™: I can help you with:
- Validate SEA-DSL specifications
- Generate code from specs
- Query the Knowledge Graph
- Analyze semantic debt
- Run governance checks

3. Configure Zed IDE (3 min)

Install Dependencies

1
2
cd /path/to/SEA™
pip install httpx rdflib

Add to Zed Settings

~/.config/zed/settings.json:

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "agent": {
    "command": "python",
    "args": ["-m", "libs.sea.adapters.acp.src.cli"],
    "cwd": "/path/to/SEA™"
  },
  "lsp": {
    "sea-dsl": {
      "command": "python",
      "args": ["-m", "tools.lsp_server"]
    }
  }
}

Verify Connection

Open Zed → View → Agent Panel → SEA-Forge™ Agent should appear.

4. Test Both Interfaces (5 min)

LibreChat Test

1
2
3
4
5
6
You: Validate the spec at docs/specs/shared/kernel.sea

SEA™: ✅ Validation passed
- Syntax: valid
- Types: consistent
- Policies: 1 validated

Zed IDE Test

1. Open docs/specs/shared/kernel.sea
2. Open Command Palette (Cmd+Shift+P)
3. Run: SEA™: Validate Current File

Expected: Green checkmark in status bar

5. Environment Variables

Create .env in project root:

1
2
3
4
5
6
7
8
9
10
11
12
13
# SEA™ API
SEA_API_URL=http://localhost:8080
SEA_API_KEY=your-key

# LLM Provider (optional)
LLM_PROVIDER_URL=http://localhost:8000
OLLAMA_BASE_URL=http://localhost:11434

# Knowledge Graph
OXIGRAPH_URL=http://localhost:7878

# Observability
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

Troubleshooting

Next Steps

1. LibreChat Power User: LibreChat_Setup.md
2. Zed Deep Dive: Zed_Setup.md
3. Advanced Workflows: Power_Features.md

Last Updated: January 2026