How ebony-vinyl/dsh-our-free-model works
This repository is a dsh model-provider plugin plus a separate standalone local service. The main workflow mounts the plugin, refreshes model catalogs and availability for the host’s network, exposes routable models to the selector, and streams completions through provider adapters; users can also call a local OpenAI/Anthropic-compatible gateway. Other major capabilities include account-based channels, EAC/Kilo/aggregate lanes, routing chains, token saving, usage/settings UI, announcements, upgrades, and a separate management web app. Several relationships below are documented in the README; unsampled implementations are represented at subsystem-directory level.
Main entry points: adapter.js Completion adapter · runtime.js Model runtime · service.mjs Standalone service · index.js Plugin mount
Components 25
Plugin runtime
- Plugin mount
index.js - Model runtime
src/core/runtime.js - Model selector
src/adapter.js
Model lanes
- Model catalogs
src/catalog.js - Availability probe
src/probe.js - Anonymous free lane
src/upstream.js - Kilo lane
src/kilo.js - EAC lane
src/eac.js - Account channels
src/channel.js - Aggregate providers
src/aggregate.js - Fallback chains
src/combos.js
Request serving
- Completion adapter
src/adapter.js - Token saving
src/token-saver/index.js - Local API gateway
src/forward.js - Anthropic API
src/anthropic.js
Management
- Usage statistics
src/core/stats.js - Settings and dashboard
index.js - Announcements
src/feed.js - In-app upgrade
src/updater.js
Standalone service
- Standalone service
packages/standalone/service.mjs - Standalone channels
packages/standalone/channels/worker.mjs - Management API
packages/standalone/management.mjs - Web management UI
packages/standalone/frontend/app.tsx
Other components
- dsh user
- Model gateways
Connections 32
- dsh user → Plugin mount: installs and uses
README.md - Plugin mount → Model runtime: starts runtime
index.js - Model runtime → Model catalogs: builds catalogs
src/core/runtime.js - Model runtime → Availability probe: probes egress
src/core/runtime.js - Model runtime → Model selector: publishes models
src/core/runtime.js - Model catalogs → Anonymous free lane: refreshes listing
src/catalog.js - Model runtime → EAC lane: fetches sealed listing
src/core/runtime.js - Model runtime → Aggregate providers: builds aggregate catalog
src/core/runtime.js - Model runtime → Fallback chains: builds chain catalog
src/core/runtime.js - Model selector → Completion adapter: selects model
src/adapter.js - Completion adapter → Token saving: rewrites request
src/adapter.js - Completion adapter → Anonymous free lane: sends completion
src/adapter.js - Completion adapter → Kilo lane: routes completion
README.md - Completion adapter → EAC lane: routes completion
README.md - Completion adapter → Account channels: routes completion
README.md - Completion adapter → Aggregate providers: routes completion
README.md - Completion adapter → Fallback chains: resolves chain
src/adapter.js - Anonymous free lane → Model gateways: calls gateway
- Local API gateway → Completion adapter: requests completion
src/core/completion.js - Local API gateway → Anthropic API: translates messages
src/forward.js - dsh user → Local API gateway: calls local API
README.md - Plugin mount → Settings and dashboard: registers controls
index.js - Settings and dashboard → Usage statistics: reads usage
index.js - Plugin mount → Announcements: provides announcements
README.md - Settings and dashboard → In-app upgrade: triggers upgrades
README.md - dsh user → Standalone service: starts service
README.md - Standalone service → Model runtime: creates model runtime
packages/standalone/service.mjs - Standalone service → Local API gateway: starts API listener
packages/standalone/service.mjs - Standalone service → Standalone channels: starts channels
packages/standalone/service.mjs - Standalone service → Management API: creates management API
packages/standalone/service.mjs - Management API → Web management UI: serves management UI
README.md - dsh user → Web management UI: manages service
README.md