Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · LLMReleased 2025-01-10

How to Use Phi-4 in Gemini CLI

Phi-4 suits math problems, logic checks, and Python code tasks. Its 14-billion-parameter model has a 16K-token context window; use English prompts and check factual claims against supplied sources.

Prompts to try with Phi-4 in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use Phi-4 to review the project's Python percentage-change calculation. Find a concrete input that exposes a bug, propose the smallest correction, and add a regression test with a verified expected result.

Phi-4Gemini CLI
Try asking
  • Use Phi-4 to draft a Python helper that groups the project's event records by day using datetime and collections. Read the existing data structures first, preserve the project's timezone convention, and test empty input and a midnight boundary.

  • Use Phi-4 to inspect the project's weighted-average function. Compare its behavior with the documented formula, check zero total weight, and propose a correction only if you can demonstrate a mismatch.

  • Use Phi-4 to propose boundary tests for the project's Python date-range utility. Cover leap day, month end, and reversed dates, then verify the expected results before adding tests.

  • Use Phi-4 to review one Python function touched by the current diff. Supply only the function, its relevant callers, and its intended behavior; return up to three logic concerns with concrete examples.

How to set up Phi-4 in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Phi-4

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "openrouter",
        "model": "microsoft/phi-4",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Phi-4 on Spiral, shows the price and runs it.

Phi-4 providers and prices

Spiral runs Phi-4 through OpenRouter. Open a card for today's price, with every fee included.

OpenRouterLLM
Microsoft: Phi 4
microsoft/phi-4

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number
Min p0 to 1
Top ka whole number from 0
Top p0 to 1
Max tokens1 to 14745

The most output tokens to generate.

Temperature0 to 2
Presence penalty-2 to 2
Frequency penalty-2 to 2
Repetition penalty0 to 2

Every API field of Microsoft: Phi 4 is on its tool page: open its card above.

What can you do with Phi-4 in Gemini CLI?

Use Phi-4 to draft Python helpers, inspect calculation logic, and propose focused tests from project code. Give it a small, self-contained task, then run the proposed code and check unfamiliar APIs.

Check business calculations

Ask Phi-4 to review percentage changes, weighted averages, and unit conversions using supplied numbers. Request the formula and a short calculation you can verify.

Draft small Python utilities

Use Phi-4 to draft focused functions for counting records, grouping values, or calculating summary statistics. Specify the input, expected result, and edge cases.

Review Python logic

Give Phi-4 a function and its intended behavior. Ask for a failing example and a proposed correction, then run the example yourself.

Propose Python test cases

Ask Phi-4 for normal, boundary, and invalid-input cases for a small function. Review the expected results before adding the tests.

Explain math mistakes

Provide a problem and an attempted solution. Ask Phi-4 to identify the first incorrect step and explain a correction at the learner's level.

Check plans against constraints

Supply scheduling rules, dependencies, and resource limits. Ask Phi-4 to identify conflicts and propose a plan that satisfies the stated constraints.

Work through science exercises

Provide an exercise, its assumptions, and any required reference material. Ask Phi-4 for a concise explanation with equations, units, and a check of the result.

Questions about Phi-4 in Gemini CLI

Can Gemini CLI use Phi-4?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Phi-4 like any built-in tool.

How much does Phi-4 cost in Gemini CLI?

Up to $0.000749 per run at the default inputs. $0.091 per 1M input tokens, $0.182 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

Do I need an OpenRouter account to use Phi-4 in Gemini CLI?

No. Spiral runs Phi-4 on its own OpenRouter account. You sign in to Spiral once and never paste a key.

How long does it take to set up Phi-4 in Gemini CLI?

About two minutes: add the server, then sign in, then check it.

Does Gemini CLI wait while Phi-4 runs?

Phi-4 runs in the background. Gemini CLI starts the run, checks on it and gives you the text, json when it's ready.

What is Phi-4 good at?

Mathematical reasoning is a documented strength. Try it for checking calculations, solving constrained problems, and explaining a mathematical solution.

How much text can Phi-4 handle?

Phi-4 has a 16K-token context window. Keep the instructions, relevant conversation, source material, and requested response within that budget.

Which language should I use with Phi-4?

Use English when possible. Microsoft says performance is worse in other languages, so evaluate your actual tasks before relying on multilingual output.

Is Phi-4 useful for coding?

Python is the best-supported starting point in its documented code training. Check generated code against tests, and verify unfamiliar packages or APIs against their documentation.

Can I trust Phi-4's factual answers and formatting?

Phi-4 can invent factual details and miss strict formatting requirements. Supply the evidence you want it to use, check claims against that evidence, and validate outputs before a program consumes them.

Get started

Start using Phi-4 in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options