llmkit-cli 0.1.1__tar.gz → 0.1.2__tar.gz

{llmkit_cli-0.1.1 → llmkit_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llmkit-cli
-Version: 0.1.1
+Version: 0.1.2
 Summary: Run any LLM with one config file. No framework lock-in.
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/abinz-aiml/llmkit
@@ -26,12 +26,24 @@ Requires-Dist: mcp; extra == "all"
 
 Run any LLM — local or via API — with one config file. No framework lock-in. Works on Windows, Mac, Linux.
 
+```bash
+pip install llmkit-cli
+```
+
 ```bash
 llmkit run "explain this codebase in one sentence"
 ```
 
+Switch between OpenAI, Anthropic, Groq, Mistral, DeepSeek, Together, and local Ollama models by changing **one line** in `llm.yaml`. No code changes. No redeploy.
+
 ## Install
 
+**Recommended (PyPI):**
+```bash
+pip install llmkit-cli
+```
+
+**Or clone and run the platform installer:**
 ```bash
 # Linux
 bash install.sh
@@ -43,19 +55,21 @@ bash install.mac.sh
 ./install.ps1
 ```
 
-Each script installs deps, sets up Ollama if needed, and adds `llmkit` to your PATH.
+**VS Code extension:** install `vscode-llmkit` to run prompts and commands from the editor status bar.
 
 ## Configure
 
-Edit `llm.yaml` (or run `llmkit init` for a guided setup):
+Create `llm.yaml` in your project (or run `llmkit init` for a guided setup):
 
 ```yaml
 provider: groq          # local | openai | anthropic | groq | together | deepseek | mistral
 model: llama-3.3-70b-versatile
-mode: chat
 ```
 
-For API providers, copy `.env.example` to `.env` and add your key.
+For API providers, add your key to `.env`:
+```
+GROQ_API_KEY=your_key_here
+```
 
 ## Commands
 
@@ -63,7 +77,7 @@ For API providers, copy `.env.example` to `.env` and add your key.
 # One-shot prompt
 llmkit run "explain this codebase in one sentence"
 
-# Validate config + check provider reachability
+# Validate config and check provider reachability
 llmkit check
 
 # Interactive wizard to create llm.yaml
@@ -72,6 +86,9 @@ llmkit init
 # Pin current model to llm.lock (commit this file)
 llmkit lock
 
+# Manage API keys in .env
+llmkit env
+
 # Generate a commit message from staged changes
 llmkit commit
 
@@ -91,50 +108,45 @@ llmkit agent --plan "add pagination to the API"
 llmkit agent --approve "run the test suite and fix any failures"
 ```
 
-## Examples
-
-```bash
-# Chat
-python examples/chat.py
-node examples/chat.js          # all providers including Anthropic
-
-# Streaming
-python examples/stream.py
-node examples/stream.js        # all providers including Anthropic
+## Switch providers
 
-# Function calling / tools
-python examples/tools.py
+Change one line in `llm.yaml`, run `llmkit check`, done:
 
-# Vision (image input)
-python examples/vision.py
+```yaml
+# was: provider: groq
+provider: anthropic
+model: claude-3-5-haiku-20241022
+```
 
-# Multi-round conversation
-python examples/multiround.py
+No code changes. No redeploy. Works in CI too.
 
-# Embeddings + cosine similarity
-python examples/embed.py
+## Fallback
 
-# Coding agent
-python examples/agent.py
+If the primary provider fails, llmkit cascades to the next:
 
-# MCP agent (connects to MCP servers defined in llm.yaml)
-python examples/mcp_agent.py
+```yaml
+provider: groq
+model: llama-3.3-70b-versatile
+fallback:
+  - provider: openai
+    model: gpt-4o-mini
+  - provider: anthropic
+    model: claude-3-5-haiku-20241022
 ```
 
-## Local models (via Ollama)
+## Budget
 
-| Model | Config |
-|---|---|
-| Llama 4 | `model: llama4` |
-| Qwen 3 | `model: qwen3` |
-| DeepSeek R1 | `model: deepseek-r1` |
-| Mistral | `model: mistral` |
-| Phi-4 | `model: phi4` |
-| Gemma 3 | `model: gemma3` |
+Cap token usage per run:
+
+```yaml
+budget:
+  max_tokens_per_run: 10000
+  warn_at: 8000
+```
 
 ## API providers
 
-| Provider | Env key | Fast cheap model |
+| Provider | Env key | Fast model |
 |---|---|---|
 | OpenAI | `OPENAI_API_KEY` | `gpt-4o-mini` |
 | Anthropic | `ANTHROPIC_API_KEY` | `claude-3-5-haiku-20241022` |
@@ -143,50 +155,60 @@ python examples/mcp_agent.py
 | DeepSeek | `DEEPSEEK_API_KEY` | `deepseek-chat` |
 | Mistral | `MISTRAL_API_KEY` | `mistral-small-latest` |
 
-## 5-minute team setup
-
-```bash
-# 1 — clone
-git clone https://github.com/your-org/llmkit
-cd llmkit
-
-# 2 — install deps + register llmkit command
-bash install.sh          # Mac: bash install.mac.sh  |  Windows: ./install.ps1
-
-# 3 — set one API key (Groq free tier works)
-echo "GROQ_API_KEY=your_key_here" > .env
-
-# 4 — verify everything is wired up
-llmkit check
+## Local models (via Ollama)
 
-# 5 — run your first prompt
-llmkit run "explain this codebase in one sentence"
+```yaml
+provider: local
+model: llama4       # or qwen3, deepseek-r1, mistral, phi4, gemma3
 ```
 
-No server. No IDE extension. No code to write. Switch providers by editing one line in `llm.yaml`.
-
 ## llm.lock
 
-Run `llmkit lock` to pin your model runtime. Commit `llm.lock` alongside your code:
+Run `llmkit lock` to pin your model runtime. Commit `llm.lock` alongside your code — same idea as `package-lock.json`:
 
 ```yaml
-# Auto-generated — commit this file to pin your model runtime
 locked_at: "2026-06-26T12:00:00Z"
 provider: groq
 model: llama-3.3-70b-versatile
-mode: chat
 ```
 
-Same idea as `package-lock.json` — reproducible environments, no surprise model swaps between teammates.
+## 5-minute team setup
 
-## Switch providers
+```bash
+# 1 — install
+pip install llmkit-cli
 
-Change one line in `llm.yaml`, run `llmkit check`, done:
+# 2 — set one API key (Groq free tier works)
+echo "GROQ_API_KEY=your_key_here" > .env
 
-```yaml
-# was: provider: groq
-provider: anthropic
-model: claude-3-5-haiku-20241022
+# 3 — create config
+llmkit init
+
+# 4 — verify
+llmkit check
+
+# 5 — run
+llmkit run "explain this codebase in one sentence"
 ```
 
-No code changes. No redeploy. Works in CI too.
+No server. No IDE plugin required. No code to write.
+
+## Examples
+
+```bash
+python examples/chat.py
+python examples/stream.py
+python examples/tools.py        # function calling
+python examples/multiround.py   # multi-round conversation
+python examples/embed.py        # embeddings + cosine similarity
+python examples/agent.py        # coding agent
+python examples/mcp_agent.py    # MCP agent
+
+node examples/chat.js           # JS — all providers
+node examples/stream.js         # JS — streaming
+```
+
+## Links
+
+- PyPI: https://pypi.org/project/llmkit-cli/
+- GitHub: https://github.com/abinz-aiml/llmkit

{llmkit_cli-0.1.1 → llmkit_cli-0.1.2}/README.md

@@ -2,12 +2,24 @@
 
 Run any LLM — local or via API — with one config file. No framework lock-in. Works on Windows, Mac, Linux.
 
+```bash
+pip install llmkit-cli
+```
+
 ```bash
 llmkit run "explain this codebase in one sentence"
 ```
 
+Switch between OpenAI, Anthropic, Groq, Mistral, DeepSeek, Together, and local Ollama models by changing **one line** in `llm.yaml`. No code changes. No redeploy.
+
 ## Install
 
+**Recommended (PyPI):**
+```bash
+pip install llmkit-cli
+```
+
+**Or clone and run the platform installer:**
 ```bash
 # Linux
 bash install.sh
@@ -19,19 +31,21 @@ bash install.mac.sh
 ./install.ps1
 ```
 
-Each script installs deps, sets up Ollama if needed, and adds `llmkit` to your PATH.
+**VS Code extension:** install `vscode-llmkit` to run prompts and commands from the editor status bar.
 
 ## Configure
 
-Edit `llm.yaml` (or run `llmkit init` for a guided setup):
+Create `llm.yaml` in your project (or run `llmkit init` for a guided setup):
 
 ```yaml
 provider: groq          # local | openai | anthropic | groq | together | deepseek | mistral
 model: llama-3.3-70b-versatile
-mode: chat
 ```
 
-For API providers, copy `.env.example` to `.env` and add your key.
+For API providers, add your key to `.env`:
+```
+GROQ_API_KEY=your_key_here
+```
 
 ## Commands
 
@@ -39,7 +53,7 @@ For API providers, copy `.env.example` to `.env` and add your key.
 # One-shot prompt
 llmkit run "explain this codebase in one sentence"
 
-# Validate config + check provider reachability
+# Validate config and check provider reachability
 llmkit check
 
 # Interactive wizard to create llm.yaml
@@ -48,6 +62,9 @@ llmkit init
 # Pin current model to llm.lock (commit this file)
 llmkit lock
 
+# Manage API keys in .env
+llmkit env
+
 # Generate a commit message from staged changes
 llmkit commit
 
@@ -67,50 +84,45 @@ llmkit agent --plan "add pagination to the API"
 llmkit agent --approve "run the test suite and fix any failures"
 ```
 
-## Examples
-
-```bash
-# Chat
-python examples/chat.py
-node examples/chat.js          # all providers including Anthropic
-
-# Streaming
-python examples/stream.py
-node examples/stream.js        # all providers including Anthropic
+## Switch providers
 
-# Function calling / tools
-python examples/tools.py
+Change one line in `llm.yaml`, run `llmkit check`, done:
 
-# Vision (image input)
-python examples/vision.py
+```yaml
+# was: provider: groq
+provider: anthropic
+model: claude-3-5-haiku-20241022
+```
 
-# Multi-round conversation
-python examples/multiround.py
+No code changes. No redeploy. Works in CI too.
 
-# Embeddings + cosine similarity
-python examples/embed.py
+## Fallback
 
-# Coding agent
-python examples/agent.py
+If the primary provider fails, llmkit cascades to the next:
 
-# MCP agent (connects to MCP servers defined in llm.yaml)
-python examples/mcp_agent.py
+```yaml
+provider: groq
+model: llama-3.3-70b-versatile
+fallback:
+  - provider: openai
+    model: gpt-4o-mini
+  - provider: anthropic
+    model: claude-3-5-haiku-20241022
 ```
 
-## Local models (via Ollama)
+## Budget
 
-| Model | Config |
-|---|---|
-| Llama 4 | `model: llama4` |
-| Qwen 3 | `model: qwen3` |
-| DeepSeek R1 | `model: deepseek-r1` |
-| Mistral | `model: mistral` |
-| Phi-4 | `model: phi4` |
-| Gemma 3 | `model: gemma3` |
+Cap token usage per run:
+
+```yaml
+budget:
+  max_tokens_per_run: 10000
+  warn_at: 8000
+```
 
 ## API providers
 
-| Provider | Env key | Fast cheap model |
+| Provider | Env key | Fast model |
 |---|---|---|
 | OpenAI | `OPENAI_API_KEY` | `gpt-4o-mini` |
 | Anthropic | `ANTHROPIC_API_KEY` | `claude-3-5-haiku-20241022` |
@@ -119,50 +131,60 @@ python examples/mcp_agent.py
 | DeepSeek | `DEEPSEEK_API_KEY` | `deepseek-chat` |
 | Mistral | `MISTRAL_API_KEY` | `mistral-small-latest` |
 
-## 5-minute team setup
-
-```bash
-# 1 — clone
-git clone https://github.com/your-org/llmkit
-cd llmkit
-
-# 2 — install deps + register llmkit command
-bash install.sh          # Mac: bash install.mac.sh  |  Windows: ./install.ps1
-
-# 3 — set one API key (Groq free tier works)
-echo "GROQ_API_KEY=your_key_here" > .env
-
-# 4 — verify everything is wired up
-llmkit check
+## Local models (via Ollama)
 
-# 5 — run your first prompt
-llmkit run "explain this codebase in one sentence"
+```yaml
+provider: local
+model: llama4       # or qwen3, deepseek-r1, mistral, phi4, gemma3
 ```
 
-No server. No IDE extension. No code to write. Switch providers by editing one line in `llm.yaml`.
-
 ## llm.lock
 
-Run `llmkit lock` to pin your model runtime. Commit `llm.lock` alongside your code:
+Run `llmkit lock` to pin your model runtime. Commit `llm.lock` alongside your code — same idea as `package-lock.json`:
 
 ```yaml
-# Auto-generated — commit this file to pin your model runtime
 locked_at: "2026-06-26T12:00:00Z"
 provider: groq
 model: llama-3.3-70b-versatile
-mode: chat
 ```
 
-Same idea as `package-lock.json` — reproducible environments, no surprise model swaps between teammates.
+## 5-minute team setup
 
-## Switch providers
+```bash
+# 1 — install
+pip install llmkit-cli
 
-Change one line in `llm.yaml`, run `llmkit check`, done:
+# 2 — set one API key (Groq free tier works)
+echo "GROQ_API_KEY=your_key_here" > .env
 
-```yaml
-# was: provider: groq
-provider: anthropic
-model: claude-3-5-haiku-20241022
+# 3 — create config
+llmkit init
+
+# 4 — verify
+llmkit check
+
+# 5 — run
+llmkit run "explain this codebase in one sentence"
 ```
 
-No code changes. No redeploy. Works in CI too.
+No server. No IDE plugin required. No code to write.
+
+## Examples
+
+```bash
+python examples/chat.py
+python examples/stream.py
+python examples/tools.py        # function calling
+python examples/multiround.py   # multi-round conversation
+python examples/embed.py        # embeddings + cosine similarity
+python examples/agent.py        # coding agent
+python examples/mcp_agent.py    # MCP agent
+
+node examples/chat.js           # JS — all providers
+node examples/stream.js         # JS — streaming
+```
+
+## Links
+
+- PyPI: https://pypi.org/project/llmkit-cli/
+- GitHub: https://github.com/abinz-aiml/llmkit

{llmkit_cli-0.1.1 → llmkit_cli-0.1.2}/llmkit_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llmkit-cli
-Version: 0.1.1
+Version: 0.1.2
 Summary: Run any LLM with one config file. No framework lock-in.
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/abinz-aiml/llmkit
@@ -26,12 +26,24 @@ Requires-Dist: mcp; extra == "all"
 
 Run any LLM — local or via API — with one config file. No framework lock-in. Works on Windows, Mac, Linux.
 
+```bash
+pip install llmkit-cli
+```
+
 ```bash
 llmkit run "explain this codebase in one sentence"
 ```
 
+Switch between OpenAI, Anthropic, Groq, Mistral, DeepSeek, Together, and local Ollama models by changing **one line** in `llm.yaml`. No code changes. No redeploy.
+
 ## Install
 
+**Recommended (PyPI):**
+```bash
+pip install llmkit-cli
+```
+
+**Or clone and run the platform installer:**
 ```bash
 # Linux
 bash install.sh
@@ -43,19 +55,21 @@ bash install.mac.sh
 ./install.ps1
 ```
 
-Each script installs deps, sets up Ollama if needed, and adds `llmkit` to your PATH.
+**VS Code extension:** install `vscode-llmkit` to run prompts and commands from the editor status bar.
 
 ## Configure
 
-Edit `llm.yaml` (or run `llmkit init` for a guided setup):
+Create `llm.yaml` in your project (or run `llmkit init` for a guided setup):
 
 ```yaml
 provider: groq          # local | openai | anthropic | groq | together | deepseek | mistral
 model: llama-3.3-70b-versatile
-mode: chat
 ```
 
-For API providers, copy `.env.example` to `.env` and add your key.
+For API providers, add your key to `.env`:
+```
+GROQ_API_KEY=your_key_here
+```
 
 ## Commands
 
@@ -63,7 +77,7 @@ For API providers, copy `.env.example` to `.env` and add your key.
 # One-shot prompt
 llmkit run "explain this codebase in one sentence"
 
-# Validate config + check provider reachability
+# Validate config and check provider reachability
 llmkit check
 
 # Interactive wizard to create llm.yaml
@@ -72,6 +86,9 @@ llmkit init
 # Pin current model to llm.lock (commit this file)
 llmkit lock
 
+# Manage API keys in .env
+llmkit env
+
 # Generate a commit message from staged changes
 llmkit commit
 
@@ -91,50 +108,45 @@ llmkit agent --plan "add pagination to the API"
 llmkit agent --approve "run the test suite and fix any failures"
 ```
 
-## Examples
-
-```bash
-# Chat
-python examples/chat.py
-node examples/chat.js          # all providers including Anthropic
-
-# Streaming
-python examples/stream.py
-node examples/stream.js        # all providers including Anthropic
+## Switch providers
 
-# Function calling / tools
-python examples/tools.py
+Change one line in `llm.yaml`, run `llmkit check`, done:
 
-# Vision (image input)
-python examples/vision.py
+```yaml
+# was: provider: groq
+provider: anthropic
+model: claude-3-5-haiku-20241022
+```
 
-# Multi-round conversation
-python examples/multiround.py
+No code changes. No redeploy. Works in CI too.
 
-# Embeddings + cosine similarity
-python examples/embed.py
+## Fallback
 
-# Coding agent
-python examples/agent.py
+If the primary provider fails, llmkit cascades to the next:
 
-# MCP agent (connects to MCP servers defined in llm.yaml)
-python examples/mcp_agent.py
+```yaml
+provider: groq
+model: llama-3.3-70b-versatile
+fallback:
+  - provider: openai
+    model: gpt-4o-mini
+  - provider: anthropic
+    model: claude-3-5-haiku-20241022
 ```
 
-## Local models (via Ollama)
+## Budget
 
-| Model | Config |
-|---|---|
-| Llama 4 | `model: llama4` |
-| Qwen 3 | `model: qwen3` |
-| DeepSeek R1 | `model: deepseek-r1` |
-| Mistral | `model: mistral` |
-| Phi-4 | `model: phi4` |
-| Gemma 3 | `model: gemma3` |
+Cap token usage per run:
+
+```yaml
+budget:
+  max_tokens_per_run: 10000
+  warn_at: 8000
+```
 
 ## API providers
 
-| Provider | Env key | Fast cheap model |
+| Provider | Env key | Fast model |
 |---|---|---|
 | OpenAI | `OPENAI_API_KEY` | `gpt-4o-mini` |
 | Anthropic | `ANTHROPIC_API_KEY` | `claude-3-5-haiku-20241022` |
@@ -143,50 +155,60 @@ python examples/mcp_agent.py
 | DeepSeek | `DEEPSEEK_API_KEY` | `deepseek-chat` |
 | Mistral | `MISTRAL_API_KEY` | `mistral-small-latest` |
 
-## 5-minute team setup
-
-```bash
-# 1 — clone
-git clone https://github.com/your-org/llmkit
-cd llmkit
-
-# 2 — install deps + register llmkit command
-bash install.sh          # Mac: bash install.mac.sh  |  Windows: ./install.ps1
-
-# 3 — set one API key (Groq free tier works)
-echo "GROQ_API_KEY=your_key_here" > .env
-
-# 4 — verify everything is wired up
-llmkit check
+## Local models (via Ollama)
 
-# 5 — run your first prompt
-llmkit run "explain this codebase in one sentence"
+```yaml
+provider: local
+model: llama4       # or qwen3, deepseek-r1, mistral, phi4, gemma3
 ```
 
-No server. No IDE extension. No code to write. Switch providers by editing one line in `llm.yaml`.
-
 ## llm.lock
 
-Run `llmkit lock` to pin your model runtime. Commit `llm.lock` alongside your code:
+Run `llmkit lock` to pin your model runtime. Commit `llm.lock` alongside your code — same idea as `package-lock.json`:
 
 ```yaml
-# Auto-generated — commit this file to pin your model runtime
 locked_at: "2026-06-26T12:00:00Z"
 provider: groq
 model: llama-3.3-70b-versatile
-mode: chat
 ```
 
-Same idea as `package-lock.json` — reproducible environments, no surprise model swaps between teammates.
+## 5-minute team setup
 
-## Switch providers
+```bash
+# 1 — install
+pip install llmkit-cli
 
-Change one line in `llm.yaml`, run `llmkit check`, done:
+# 2 — set one API key (Groq free tier works)
+echo "GROQ_API_KEY=your_key_here" > .env
 
-```yaml
-# was: provider: groq
-provider: anthropic
-model: claude-3-5-haiku-20241022
+# 3 — create config
+llmkit init
+
+# 4 — verify
+llmkit check
+
+# 5 — run
+llmkit run "explain this codebase in one sentence"
 ```
 
-No code changes. No redeploy. Works in CI too.
+No server. No IDE plugin required. No code to write.
+
+## Examples
+
+```bash
+python examples/chat.py
+python examples/stream.py
+python examples/tools.py        # function calling
+python examples/multiround.py   # multi-round conversation
+python examples/embed.py        # embeddings + cosine similarity
+python examples/agent.py        # coding agent
+python examples/mcp_agent.py    # MCP agent
+
+node examples/chat.js           # JS — all providers
+node examples/stream.js         # JS — streaming
+```
+
+## Links
+
+- PyPI: https://pypi.org/project/llmkit-cli/
+- GitHub: https://github.com/abinz-aiml/llmkit

{llmkit_cli-0.1.1 → llmkit_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "llmkit-cli"
-version = "0.1.1"
+version = "0.1.2"
 description = "Run any LLM with one config file. No framework lock-in."
 readme = "README.md"
 requires-python = ">=3.10"