How to Use Particle-1 in Factory Droid
Particle-1 is built for debugging, code changes, and data engineering. Post-trained on DeepSeek V4.1 Flash, it targets fewer reasoning and tool-call tokens while keeping task accuracy close to that model.
Prompts to try with Particle-1 in Factory Droid
Copy an example into Factory Droid, or ask in your own words.
Use Particle-1 to inspect this project's failing build, identify the first actionable error, make a targeted fix, and rerun the affected checks.
Use Particle-1 to fix keyboard navigation in this React project's menu. Add a focused regression test and report the behavior you verified.
Use Particle-1 to trace product ID types through this dbt project. Correct inconsistent casts and check joins for lost or duplicated rows.
Use Particle-1 to investigate this repository's async startup failure. Check dependency order, implement a fix, and test both successful startup and dependency failure.
Use Particle-1 to review this project's merge-conflict handling. Add a regression case for the reported failure and document any behavior the fix changes.
How to set up Particle-1 in Factory Droid
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Droid saves it to your user config, ~/.factory/mcp.json, so it works in every project.
droid mcp add spiral https://api.spiral.ai/mcp --type http
- Sign in
Start droid, type /mcp, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.
- Check it
Spiral shows as connected. needs authentication means the sign-in did not finish: run /mcp again.
droid mcp list
Use the Spiral skill
- Send Factory Droid this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Particle-1
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": "particle-ai/particle-1", "input": { "messages": [ { "role": "system" } ] } }'
Then paste one of the prompts above: Factory Droid finds Particle-1 on Spiral, shows the price and runs it.
Particle-1 providers and prices
Spiral runs Particle-1 through OpenRouter. Open a card for today's price, with every fee included.
Up to $0.002667 per run at the default inputs. $0.091 per 1M input tokens, $0.65 per 1M output tokens.
Settings you can ask for
Ask Factory Droid for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Seed | a whole number | ||
| Min p | 0 to 1 | ||
| Top k | a whole number from 0 | ||
| Top p | 0 to 1 | ||
| Logprobs | on or off | ||
| Max tokens | 1 to 131072 | The most output tokens to generate. | |
| Temperature | 0 to 2 | ||
| Top logprobs | 0 to 20 | ||
| Presence penalty | -2 to 2 | ||
| Reasoning effort | none, minimal, low, medium, high, xhigh, or max | high | How much the model reasons. |
| Frequency penalty | -2 to 2 | ||
| Repetition penalty | 0 to 2 |
Every API field of Particle AI: Particle-1 is on its tool page: open its card above.
What can you do with Particle-1 in Factory Droid?
Turn project requirements and failing checks into code changes with Particle-1. Give it concrete acceptance criteria and name the tests it must complete.
Fix a failing build
Use Particle-1 to inspect compiler errors, identify the cause, propose a targeted fix, and verify the build.
Repair a React interaction
Ask Particle-1 to correct broken navigation or row selection and check the affected behavior.
Correct dbt transformations
Have Particle-1 trace inconsistent types or key generation through a dbt project and propose tests.
Implement a codebase change
Give Particle-1 a concrete requirement and acceptance criteria, then request an implementation with regression checks.
Plan a debugging session
Provide an error trace and relevant code. Ask Particle-1 for ranked hypotheses and checks that distinguish them.
Triage recurring engineering failures
Use Particle-1 to review incoming build errors or data-job failures and draft investigation steps.
Produce structured engineering reports
Ask Particle-1 for JSON summaries of errors, proposed fixes, and verification evidence, then validate the results.
More on Particle-1 and Factory Droid
Particle-1 in other agents
More Factory Droid guides
Questions about Particle-1 in Factory Droid
Can Factory Droid use Particle-1?
Yes. Add Spiral to Factory Droid as an MCP server, and Factory Droid can find and run Particle-1 like any built-in tool.
How much does Particle-1 cost in Factory Droid?
Up to $0.002667 per run at the default inputs. $0.078 per 1M input tokens, $0.65 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Factory Droid plan is separate.
Do I need an OpenRouter account to use Particle-1 in Factory Droid?
No. Spiral runs Particle-1 on its own OpenRouter account. You sign in to Spiral once and never paste a key.
How long does it take to set up Particle-1 in Factory Droid?
About two minutes: add the server, then sign in, then check it.
Does Factory Droid wait while Particle-1 runs?
Particle-1 runs in the background. Factory Droid starts the run, checks on it and gives you the text, json when it's ready.
What is Particle-1 best suited for?
Particle-1 focuses on software engineering and data engineering. Its published evaluations cover terminal tasks, React fixes, dbt projects, and codebase changes.
How does Particle-1 compare with DeepSeek V4.1 Flash?
Particle-1 is post-trained on DeepSeek V4.1 Flash to use fewer tokens. Particle reports 28.4% to 52.2% fewer output tokens across four engineering benchmarks, with pass rates within the base model's confidence intervals.
How much context and output can Particle-1 handle?
The context window holds 1,048,576 tokens across the prompt and completion. The output ceiling is 131,072 tokens, including reasoning.
When should I reduce Particle-1's reasoning?
Consider lower effort for straightforward explanations or narrow edits, and compare results on representative tasks. Reasoning is enabled by default and consumes part of the output allowance.
Can I rely on Particle-1 to match a JSON schema?
Validate the result before your application uses it. Particle's documentation distinguishes valid JSON from guaranteed compliance with your application's schema.
Start using Particle-1 in Factory Droid
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Factory Droid:
set up https://spiral.ai/SKILL.md


