Text Generation
PEFT
Safetensors
GGUF
English
q4_k_m
docker-model-runner
lora
codegeist-training
conversational
Instructions to use codegeist/codegeist-llm with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- PEFT
How to use codegeist/codegeist-llm with PEFT:
from peft import PeftModel from transformers import AutoModelForCausalLM base_model = AutoModelForCausalLM.from_pretrained("Qwen/Qwen3-1.7B") model = PeftModel.from_pretrained(base_model, "codegeist/codegeist-llm") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use codegeist/codegeist-llm with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf codegeist/codegeist-llm:Q4_K_M # Run inference directly in the terminal: llama cli -hf codegeist/codegeist-llm:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf codegeist/codegeist-llm:Q4_K_M # Run inference directly in the terminal: llama cli -hf codegeist/codegeist-llm:Q4_K_M
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf codegeist/codegeist-llm:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf codegeist/codegeist-llm:Q4_K_M
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf codegeist/codegeist-llm:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf codegeist/codegeist-llm:Q4_K_M
Use Docker
docker model run hf.co/codegeist/codegeist-llm:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use codegeist/codegeist-llm with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "codegeist/codegeist-llm" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "codegeist/codegeist-llm", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/codegeist/codegeist-llm:Q4_K_M
- Ollama
How to use codegeist/codegeist-llm with Ollama:
ollama run hf.co/codegeist/codegeist-llm:Q4_K_M
- Unsloth Studio
How to use codegeist/codegeist-llm with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for codegeist/codegeist-llm to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for codegeist/codegeist-llm to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for codegeist/codegeist-llm to start chatting
- Pi
How to use codegeist/codegeist-llm with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf codegeist/codegeist-llm:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "codegeist/codegeist-llm:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- OpenClaw new
How to use codegeist/codegeist-llm with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf codegeist/codegeist-llm:Q4_K_M
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "codegeist/codegeist-llm:Q4_K_M" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
- Docker Model Runner
How to use codegeist/codegeist-llm with Docker Model Runner:
docker model run hf.co/codegeist/codegeist-llm:Q4_K_M
- Lemonade
How to use codegeist/codegeist-llm with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull codegeist/codegeist-llm:Q4_K_M
Run and chat with the model
lemonade run user.codegeist-llm-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use codegeist/codegeist-llm with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf codegeist/codegeist-llm:Q4_K_M
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default codegeist/codegeist-llm:Q4_K_M
Run Hermes
hermes
- Atomic Chat
| base_model: Qwen/Qwen3-1.7B | |
| base_model_relation: adapter | |
| library_name: peft | |
| pipeline_tag: text-generation | |
| inference: false | |
| language: | |
| - en | |
| license: other | |
| license_name: 0bsd | |
| license_link: https://github.com/codegeist-ai/codegeist-ai/blob/main/LICENSE | |
| tags: | |
| - peft | |
| - lora | |
| - sft | |
| - transformers | |
| - unsloth | |
| - non-production | |
| - identity-smoke | |
| # Codegeist Qwen3-1.7B Identity Smoke Adapter | |
| This is a non-production LoRA adapter created to validate the Codegeist training | |
| pipeline. It teaches one response only: | |
| ```text | |
| User: What is Codegeist? | |
| Assistant: Codegeist is a coding agent. | |
| ``` | |
| It is not evidence of coding ability, reasoning, generalization, safe tool use, | |
| Codegeist OS integration, GGUF conversion, Vulkan deployment, or production | |
| model quality. | |
| ## Artifact Identity | |
| | Field | Value | | |
| | --- | --- | | |
| | Base model | `Qwen/Qwen3-1.7B` | | |
| | Base revision | `70d244cc86ccca08cf5af4e1e306ecf908b1ad5e` | | |
| | Adapter format | PEFT LoRA, Safetensors | | |
| | Adapter weight SHA-256 | `19d424106ef88ffeac4c26c22cebfb13ae1d5f309e1dcccf2da708727bec10a8` | | |
| | Training Job | `6a75f25a3e1f34a7e32bd646` | | |
| | Training date | 2026-08-07 | | |
| `evidence.json` contains the sanitized run chronology, configuration, package | |
| versions, hashes, cost estimate, verification status, and known gaps. It does | |
| not contain model weights, private logs, or credentials. | |
| ## Intended Use | |
| The only intended use is reproducing and inspecting this one-record pipeline | |
| smoke. Use the immutable base revision above and pin this adapter repository to | |
| a specific Hub commit when loading it. | |
| Do not use this adapter as a coding assistant, autonomous agent, general chat | |
| model, safety component, or production model. It was not evaluated for those | |
| purposes. | |
| ## Loading | |
| This CPU-compatible example prioritizes portability over speed. Replace | |
| `ADAPTER_REVISION` with an immutable commit from this repository: | |
| ```python | |
| import torch | |
| from peft import PeftModel | |
| from transformers import AutoModelForCausalLM, AutoTokenizer | |
| BASE_MODEL = "Qwen/Qwen3-1.7B" | |
| BASE_REVISION = "70d244cc86ccca08cf5af4e1e306ecf908b1ad5e" | |
| ADAPTER_MODEL = "codegeist/qwen3-1.7b-codegeist-identity-smoke" | |
| ADAPTER_REVISION = "04d51edac56c6f1e068c644bfa8d014cadcecf9f" | |
| tokenizer = AutoTokenizer.from_pretrained( | |
| BASE_MODEL, | |
| revision=BASE_REVISION, | |
| trust_remote_code=False, | |
| ) | |
| base_model = AutoModelForCausalLM.from_pretrained( | |
| BASE_MODEL, | |
| revision=BASE_REVISION, | |
| trust_remote_code=False, | |
| torch_dtype=torch.float32, | |
| low_cpu_mem_usage=True, | |
| ) | |
| model = PeftModel.from_pretrained( | |
| base_model, | |
| ADAPTER_MODEL, | |
| revision=ADAPTER_REVISION, | |
| is_trainable=False, | |
| ) | |
| prompt = tokenizer.apply_chat_template( | |
| [{"role": "user", "content": "What is Codegeist?"}], | |
| tokenize=False, | |
| add_generation_prompt=True, | |
| enable_thinking=False, | |
| ) | |
| inputs = tokenizer(prompt, return_tensors="pt", add_special_tokens=False) | |
| with torch.inference_mode(): | |
| output = model.generate( | |
| **inputs, | |
| do_sample=False, | |
| temperature=None, | |
| top_p=None, | |
| top_k=None, | |
| max_new_tokens=64, | |
| pad_token_id=tokenizer.eos_token_id, | |
| eos_token_id=tokenizer.eos_token_id, | |
| ) | |
| response = tokenizer.decode( | |
| output[0, inputs["input_ids"].shape[1]:], | |
| skip_special_tokens=True, | |
| ).strip() | |
| print(response) | |
| ``` | |
| Expected whitespace-normalized response: | |
| ```text | |
| Codegeist is a coding agent. | |
| ``` | |
| ## Training Data | |
| The complete project-authored synthetic dataset is one public record: | |
| ```json | |
| { | |
| "instruction": "What is Codegeist?", | |
| "response": "Codegeist is a coding agent." | |
| } | |
| ``` | |
| The record ID is `codegeist-identity-v1-001`. It contains no private data, | |
| personal information, or credentials. Training and evaluation deliberately use | |
| the same record to test memorization; there is no held-out evaluation set. | |
| ## Training | |
| - Python 3.12 | |
| - PyTorch 2.6.0 with CUDA 12.4 | |
| - Unsloth 2026.8.7 | |
| - Transformers 5.5.0 | |
| - TRL 0.24.0 | |
| - PEFT 0.20.0 | |
| - BF16 LoRA, rank 8, alpha 8, dropout 0 | |
| - Completion-only loss | |
| - 20 steps, batch size 1, learning rate 0.0002 | |
| - Seed and data seed 3407 | |
| - NVIDIA A10G | |
| - No intermediate checkpoints and no automatic Hub publication | |
| The aggregate training loss was `1.6867698234826094`. The final logged step loss | |
| was approximately `0.0003`. | |
| ## Evaluation | |
| The unchanged base model incorrectly described Codegeist as a code editor. After | |
| training, the adapter was loaded onto a fresh instance of the exact base revision | |
| in a child process. One greedy generation produced the expected answer after | |
| leading and trailing whitespace normalization. | |
| The raw decoded continuation before `.strip()` was not retained. Training and | |
| inference repeatability, deterministic PyTorch algorithms, coding benchmarks, | |
| safety evaluation, and generalization were not tested. | |
| Before public release, an independent local CPU reload used PyTorch 2.6.0+cpu, | |
| Transformers 5.5.0, PEFT 0.20.0, the immutable base revision, and adapter commit | |
| `04d51edac56c6f1e068c644bfa8d014cadcecf9f`. In that publication test, both the | |
| raw and whitespace-normalized responses were exactly | |
| `Codegeist is a coding agent.`. This confirms public-artifact loading and the | |
| single memorized response only; it does not broaden the interpretation boundary. | |
| ## Licenses And Provenance | |
| The project-authored adapter and documentation are provided under the | |
| [BSD Zero Clause License](https://github.com/codegeist-ai/codegeist-ai/blob/main/LICENSE). | |
| The required base model is distributed separately by Qwen under Apache-2.0. This | |
| repository does not redistribute base-model weights. Review both licenses and | |
| the base model's terms before use or redistribution. | |
| See `THIRD_PARTY_NOTICES.md` for the exact upstream model reference. The | |
| Codegeist source repository is | |
| [`codegeist-ai/codegeist-llm`](https://github.com/codegeist-ai/codegeist-llm). | |
| ## Publication Limitations | |
| - The successful training source was not committed when the paid Job launched; | |
| exact source bytes are anchored by SHA-256 in `evidence.json`. | |
| - Downloaded model and tokenizer cache bytes were not independently rehashed | |
| inside the Job against the upstream manifest. | |
| - The generated adapter configuration originally omitted the base revision; the | |
| publication copy sets it to the immutable revision used by the Job. | |
| - This publication does not change the experiment's non-production status. | |