Text Generation
ONNX
GGUF
English
function-calling
edge
on-device
physical-ai
iot
octopus-v2
synaptics-sl2619
gemma3
conversational
Instructions to use BrinqAI/functiongemma-270m-physical-ai with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use BrinqAI/functiongemma-270m-physical-ai 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 BrinqAI/functiongemma-270m-physical-ai:Q4_K_M # Run inference directly in the terminal: llama cli -hf BrinqAI/functiongemma-270m-physical-ai:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf BrinqAI/functiongemma-270m-physical-ai:Q4_K_M # Run inference directly in the terminal: llama cli -hf BrinqAI/functiongemma-270m-physical-ai:Q4_K_M
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf BrinqAI/functiongemma-270m-physical-ai:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama cli -hf BrinqAI/functiongemma-270m-physical-ai:Q4_K_M
Use Docker
docker model run hf.co/BrinqAI/functiongemma-270m-physical-ai:Q4_K_M
- Llama new
- LM Studio
- Jan
- vLLM
How to use BrinqAI/functiongemma-270m-physical-ai with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "BrinqAI/functiongemma-270m-physical-ai" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "BrinqAI/functiongemma-270m-physical-ai", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/BrinqAI/functiongemma-270m-physical-ai:Q4_K_M
- Ollama
How to use BrinqAI/functiongemma-270m-physical-ai with Ollama:
ollama run hf.co/BrinqAI/functiongemma-270m-physical-ai:Q4_K_M
- Unsloth Desktop
- Pi
How to use BrinqAI/functiongemma-270m-physical-ai with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf BrinqAI/functiongemma-270m-physical-ai: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": "BrinqAI/functiongemma-270m-physical-ai:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use BrinqAI/functiongemma-270m-physical-ai with Docker Model Runner:
docker model run hf.co/BrinqAI/functiongemma-270m-physical-ai:Q4_K_M
- Lemonade
How to use BrinqAI/functiongemma-270m-physical-ai with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull BrinqAI/functiongemma-270m-physical-ai:Q4_K_M
Run and chat with the model
lemonade run user.functiongemma-270m-physical-ai-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use BrinqAI/functiongemma-270m-physical-ai with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf BrinqAI/functiongemma-270m-physical-ai: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 BrinqAI/functiongemma-270m-physical-ai:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use BrinqAI/functiongemma-270m-physical-ai with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf BrinqAI/functiongemma-270m-physical-ai: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 "BrinqAI/functiongemma-270m-physical-ai: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"
Commit History
-
docs: format all 'Phrases that work' sections as tables
Verified signature83e9928 -
docs: add verified 'Phrases that work' guide; fix red sparkle example; clarify multi-tool note
Verified signature61f7acc
-
v10: unified set_lights, named-args output, 6 tools
Verified signature- Replace 3 LED tools (set_status_led / blink_status_led / set_neopixel_effect) with one hardware-agnostic set_lights(color?, effect?, state?). Dispatcher resolves to HAT 3-LED indicators or WLED strip/ring at runtime. - Switch tool-call output to named-args format per Mercedes-Benz Octopus v2 (arXiv 2501.02342): <tool_0>(color=\"red\", state=\"on\")<end>. Optional args absent when user didn't imply them. - Tool surface: set_lights, play_buzzer, set_alarm, cancel_alarm, get_system_status, respond. - Training: 5,222 train / 920 eval. Final eval loss 0.046, mean token acc 97.9%. Held-out smoke 35/36 (97.2%). - On-device (Coralboard, 2-core A55, Q5_K_M): cold prefill 0.48 s, decode ~9.7 tok/s, end-to-end first turn ~3.4 s.2a22670
-
v9: schema-free inference, 100% smoke, sub-second cold prefill
Verified signatureeef4acc
-
Add Moonshine VMFB artifacts for Coralboard standalone install
Verified signature837c537
-
Update Modelfile: FROM v7 GGUF, drop <end> stop (was truncating multi-tool)
Verified signaturea8332b8 -
Update tools.json + token_map.json to v7 (10 tools, list_alarms removed)
Verified signaturec0eb2b7 -
Update model card for v7 (10 tools, list_alarms removed)
Verified signature35645d8
-
Add v7 GGUF (10-tool schema, list_alarms removed)
Verified signature408c7e9
-
docs: README updated for v6 (11 tools, Q5_K_M, single-tool 95.5%)
Verified signature6d659ec -
chore: tools.json for v6 (11 tools)
Verified signature85c8c4c -
chore: token map for v6 (11 tools, camera/vision dropped)
Verified signaturec3ed491 -
feat: v6 model (11 tools, Q5_K_M, single-tool 95.5%)
Verified signature4e15ea2 -
docs: add ONNX section + fp16/ORT caveat
Verified signature3947888 -
add ONNX fp16 export (compact / function-token)
Verified signature960c2dd -
add ONNX fp32 export (compact / function-token)
Verified signaturea3b6d68
-
Inline client snippet, link checked-in tools.json + token_map.json, drop external trainer/demo links
Verified signature598a857 -
Add token_map.json (function-token <-> tool-name map)
Verified signature78658b9 -
Add tools.json (13-tool schema, board-neutral)
Verified signaturee7ff352 -
Rewrite README: rename, single function-token format, Octopus v2 citation
Verified signaturee515857 -
Drop native Modelfile (native variant retired)
Verified signaturebfcf399 -
Remove old-name Modelfile.compact (renamed to Modelfile)
Verified signature5ce1bca -
Add Modelfile (renamed from Modelfile.compact, FROM updated)
Verified signature03fe0c2 -
Drop native-format variant (function-token format chosen)
Verified signature02bcc11 -
Remove old-name GGUF (renamed to functiongemma-physical-ai-Q4_K_M.gguf)
Verified signature6689ff5 -
Add functiongemma-physical-ai-Q4_K_M.gguf (rename from coral-functiongemma-v4c-compact)
Verified signaturee20d599 -
Use hf CLI for download (huggingface-cli retired in hub 1.0)
Verified signature5045ac2 -
Fix FROM filename to match shipped GGUF
Verified signaturee28a258 -
Fix FROM filename to match shipped GGUF
Verified signatureada14d9 -
Fix Modelfile FROM paths + clarify Ollama install paths
Verified signature17c8362
-
add README.md
Verified signatureb6ab551 -
add Modelfile.native
Verified signaturec2e7c15 -
add Modelfile.compact
Verified signature3ffaf30 -
add coral-functiongemma-v4c-native-Q4_K_M.gguf
Verified signature0425c5e -
add coral-functiongemma-v4c-compact-Q4_K_M.gguf
Verified signature08d44bd -
initial commit
Verified signaturebb37d1e