Instructions to use prithivMLmods/CogEvol-4B-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use prithivMLmods/CogEvol-4B-GGUF with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="prithivMLmods/CogEvol-4B-GGUF") messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("prithivMLmods/CogEvol-4B-GGUF", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use prithivMLmods/CogEvol-4B-GGUF 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 prithivMLmods/CogEvol-4B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf prithivMLmods/CogEvol-4B-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf prithivMLmods/CogEvol-4B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf prithivMLmods/CogEvol-4B-GGUF: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 prithivMLmods/CogEvol-4B-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf prithivMLmods/CogEvol-4B-GGUF: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 prithivMLmods/CogEvol-4B-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf prithivMLmods/CogEvol-4B-GGUF:Q4_K_M
Use Docker
docker model run hf.co/prithivMLmods/CogEvol-4B-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use prithivMLmods/CogEvol-4B-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "prithivMLmods/CogEvol-4B-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "prithivMLmods/CogEvol-4B-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/prithivMLmods/CogEvol-4B-GGUF:Q4_K_M
- SGLang
How to use prithivMLmods/CogEvol-4B-GGUF with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "prithivMLmods/CogEvol-4B-GGUF" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "prithivMLmods/CogEvol-4B-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "prithivMLmods/CogEvol-4B-GGUF" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "prithivMLmods/CogEvol-4B-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Ollama
How to use prithivMLmods/CogEvol-4B-GGUF with Ollama:
ollama run hf.co/prithivMLmods/CogEvol-4B-GGUF:Q4_K_M
- Unsloth Desktop
- Pi
How to use prithivMLmods/CogEvol-4B-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf prithivMLmods/CogEvol-4B-GGUF:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "prithivMLmods/CogEvol-4B-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use prithivMLmods/CogEvol-4B-GGUF with Docker Model Runner:
docker model run hf.co/prithivMLmods/CogEvol-4B-GGUF:Q4_K_M
- Lemonade
How to use prithivMLmods/CogEvol-4B-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull prithivMLmods/CogEvol-4B-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.CogEvol-4B-GGUF-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use prithivMLmods/CogEvol-4B-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf prithivMLmods/CogEvol-4B-GGUF: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 prithivMLmods/CogEvol-4B-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use prithivMLmods/CogEvol-4B-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf prithivMLmods/CogEvol-4B-GGUF: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 "prithivMLmods/CogEvol-4B-GGUF: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"
CogEvol-4B-GGUF
CogEvol-4B is an open, post-trained model built on Qwen3.5-4B for Learning Environment Generation (LEG) — given a natural-language course brief, it generates complete, usable learning artifacts in a single pass, either as a structured-JSON slide page or a self-contained interactive HTML page (simulations, visualizations, interactive exercises) that runs directly in the browser. As the small open member of the CogEvol family, it was trained through a three-stage recipe — mixed SFT, followed by Slide RL, then interactive-HTML RL — on 53,687 verified samples, using a hybrid rule-and-VLM reward system hardened against reward hacking so that interactivity is measured via automated probes rather than judged superficially, as detailed in the accompanying paper "CogEvol: Towards Efficient and Reliable Learning Environment Generation" (arXiv:2608.30968). It's deployable via SGLang, vLLM, or llama.cpp (with a quantized Q4_K_M GGUF at ~2.4GB also available), requires thinking mode disabled at inference and the shipped system prompt template for slide generation, and integrates with the OpenMAIC app for fully offline use, with a complete deployment guide, serving scripts, and evaluation tools available on the project's GitHub repository; it's released under the Apache 2.0 license.
Model Files
| File Name | Quant Type | File Size | File Link |
|---|---|---|---|
| CogEvol-4B.BF16.gguf | BF16 | 8.42 GB | Download |
| CogEvol-4B.Q3_K_L.gguf | Q3_K_L | 2.42 GB | Download |
| CogEvol-4B.Q3_K_M.gguf | Q3_K_M | 2.26 GB | Download |
| CogEvol-4B.Q3_K_S.gguf | Q3_K_S | 2.07 GB | Download |
| CogEvol-4B.Q4_0.gguf | Q4_0 | 2.54 GB | Download |
| CogEvol-4B.Q4_K_M.gguf | Q4_K_M | 2.71 GB | Download |
| CogEvol-4B.Q4_K_S.gguf | Q4_K_S | 2.56 GB | Download |
| CogEvol-4B.Q5_0.gguf | Q5_0 | 2.99 GB | Download |
| CogEvol-4B.Q5_K_M.gguf | Q5_K_M | 3.07 GB | Download |
| CogEvol-4B.Q5_K_S.gguf | Q5_K_S | 2.99 GB | Download |
| CogEvol-4B.mmproj-bf16.gguf | mmproj-bf16 | 676 MB | Download |
llama.cpp
LLM inference in C/C++ — https://github.com/ggml-org/llama.cpp
- Downloads last month
- -
3-bit
4-bit
5-bit
16-bit