llm-models 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maxime Golfier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# llm-models
+
+Fetch latest LLM models from [OpenRouter](https://openrouter.ai) and [models.dev](https://models.dev) APIs.
+
+Validates API responses with [Zod](https://zod.dev) schemas to detect breaking changes.
+
+## Installation
+
+### Homebrew
+
+```bash
+brew install maxgfr/tap/llm-models
+```
+
+### npm
+
+```bash
+npm install -g llm-models
+```
+
+### Binary
+
+Download the latest binary from [GitHub Releases](https://github.com/maxgfr/llm-models/releases).
+
+| Platform | Binary |
+|----------|--------|
+| macOS ARM64 | `llm-models-macos-arm64` |
+| macOS Intel | `llm-models-macos-x64` |
+| Linux x86_64 | `llm-models-linux-x64` |
+| Linux ARM64 | `llm-models-linux-arm64` |
+| Windows x64 | `llm-models-win-x64.exe` |
+
+## CLI Usage
+
+### OpenRouter
+
+```bash
+# List all models
+llm-models openrouter
+
+# Filter by provider
+llm-models openrouter --provider google
+
+# Search by name or ID
+llm-models openrouter --search "claude"
+
+# Show model count
+llm-models openrouter --count
+```
+
+### models.dev
+
+```bash
+# List all providers and models
+llm-models models-dev
+
+# Filter by provider
+llm-models models-dev --provider openai
+
+# Search models
+llm-models models-dev --search "gpt-4"
+
+# Show count
+llm-models models-dev --count
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-p, --provider <id>` | Filter by provider prefix/ID |
+| `-s, --search <term>` | Search models by name or ID |
+| `-c, --count` | Show count only |
+| `-V, --version` | Show version |
+| `-h, --help` | Show help |
+
+## Library Usage
+
+```typescript
+import { fetchOpenRouterModels, fetchModelsDevModels } from "llm-models";
+
+// Fetch from OpenRouter
+const openrouter = await fetchOpenRouterModels();
+console.log(openrouter.data.length, "models");
+
+// Fetch from models.dev
+const modelsDev = await fetchModelsDevModels();
+console.log(Object.keys(modelsDev).length, "providers");
+```
+
+### Zod Schemas
+
+All schemas are exported for custom validation:
+
+```typescript
+import { OpenRouterResponseSchema, ModelsDevResponseSchema } from "llm-models";
+
+const result = OpenRouterResponseSchema.safeParse(myData);
+if (!result.success) {
+  console.error(result.error.issues);
+}
+```
+
+### Types
+
+All types are inferred from Zod schemas:
+
+```typescript
+import type { OpenRouterModel, ModelsDevModel, ModelsDevProvider } from "llm-models";
+```
+
+## Data Sources
+
+- **OpenRouter**: https://openrouter.ai/api/v1/models
+- **models.dev**: https://models.dev/api.json
+
+## License
+
+MIT

package/build/cli.d.ts

@@ -0,0 +1 @@
+export declare function runCommand(): void;

package/build/clients/models-dev.d.ts

@@ -0,0 +1,2 @@
+import type { ModelsDevResponse } from "../types";
+export declare function fetchModelsDevModels(): Promise<ModelsDevResponse>;

package/build/clients/openrouter.d.ts

@@ -0,0 +1,2 @@
+import type { OpenRouterResponse } from "../types";
+export declare function fetchOpenRouterModels(): Promise<OpenRouterResponse>;

package/build/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+export { fetchOpenRouterModels } from "./clients/openrouter";
+export { fetchModelsDevModels } from "./clients/models-dev";
+export { OpenRouterModelSchema, OpenRouterResponseSchema, OpenRouterArchitectureSchema, OpenRouterPricingSchema, OpenRouterTopProviderSchema, OpenRouterDefaultParametersSchema, OpenRouterLinksSchema, } from "./schemas/openrouter";
+export { ModelsDevModelSchema, ModelsDevProviderSchema, ModelsDevResponseSchema, ModelsDevCostSchema, ModelsDevLimitSchema, ModelsDevModalitiesSchema, } from "./schemas/models-dev";
+export type { OpenRouterModel, OpenRouterResponse, ModelsDevModel, ModelsDevProvider, ModelsDevResponse, } from "./types";