AI-powered optimization for your Bambu Studio 3D printing projects.
Slicer Copilot analyzes your .3mf project files, understands your goals (like "Maximum Strength" or "Visual Quality"), and uses an LLM to tune your print settings automatically.
- Smart Analysis: Reads printer, filament, and process settings from your
.3mffile. - Goal-Oriented: Optimize for Strength, Speed, Visual Quality, or a Custom goal.
- Safe: Never modifies your 3D geometry. Only tunes process settings.
- Transparent: Explains why every change is made.
- Multi-Language: Supports English, Russian, Spanish, French, German, and Chinese.
- CI/CD Ready: Runs interactively or in fully automated pipelines.
- Node.js 20 or higher.
- An OpenAI-compatible API key (OpenAI, Anthropic via adapter, LocalLLM, etc.).
You can run the tool directly using npx or install it globally.
# Run directly npx slicer-copilot optimize my-project.3mf --api-key=sk- # Or install globally npm install -g slicer-copilotCreate a .env file in your project directory to store your API keys.
cp .env.example .envRequired variables:
OPENAI_API_KEY=sk-...Optional variables:
OPENAI_BASE_URL=https://api.openai.com/v1 OPENAI_MODEL=gpt-4o # Default: gpt-4.1-miniSimply run the command on your file. The tool will ask you for your optimization goal.
npx slicer-copilot optimize input.3mfWant to see what would change without writing a new file? Use --dry-run.
npx slicer-copilot optimize input.3mf --dry-runFor scripts or batch processing, use --non-interactive and provide an intent file.
npx slicer-copilot optimize input.3mf \ --non-interactive \ --intent-file intent.jsonSwitch the interface and AI reasoning language using --language.
npx slicer-copilot optimize input.3mf --language ruSupported languages:
en(English)ru(Russian)es(Spanish)fr(French)de(German)zh(Chinese)
When running interactively, you can choose from the following goals:
| Goal | Description |
|---|---|
| Balanced | A good mix of speed, quality, and strength. |
| Functional Strength | Prioritizes part durability and layer adhesion. |
| Visual Quality | Focuses on surface finish and fine details. |
| Draft / Speed | Maximizes print speed for prototypes. |
| Custom | Follows your specific instructions (e.g., "Make it watertight"). |
Here is what the tool looks like in action:
npx slicer-copilot optimize new-years-ball.3mf --output test-ny.3mf ✔ Project loaded successfully ╭ ★ Slicer Copilot ────╮ │ Project Summary │ │ new-years-ball.3mf │ ╰──────────────────────╯ ╭──────────────────────────────────┬───────────────────────────────────────────────────────────────────────────╮ │ ℹ Field │ → Details │ ├──────────────────────────────────┼───────────────────────────────────────────────────────────────────────────┤ │ ◼ File │ new-years-ball.3mf │ ├──────────────────────────────────┼───────────────────────────────────────────────────────────────────────────┤ │ ▶ Printer │ Bambu Lab H2S ● 0.4mm nozzle ● Bed: Textured PEI Plate │ ├──────────────────────────────────┼───────────────────────────────────────────────────────────────────────────┤ │ ◉ Filament │ Bambu PLA Basic @BBL H2S [PLA] │ ├──────────────────────────────────┼───────────────────────────────────────────────────────────────────────────┤ │ ❯ Profile │ 0.20mm Standard @BBL H2S │ ├──────────────────────────────────┼───────────────────────────────────────────────────────────────────────────┤ │ ☰ Process │ Layer 0.12 mm │ Walls 2 │ Infill 5% │ gyroid │ ╰──────────────────────────────────┴───────────────────────────────────────────────────────────────────────────╯ ★ Select optimization goal (↑/↓ + Enter) Balanced › Functional Strength — Maximum durability and load capacity Visual Quality Draft / Speed Custom 📝 Add notes about the model (geometry, material quirks, desired result) Press Enter to skip › ✓ Selected: Functional Strength ✔ AI analysis complete ╭─────────────────────────────╮ │ ★ 24 Suggested Changes │ ╰─────────────────────────────╯ ╭─────────────────────────────────┬─────────────────────────────┬────────────────────────────────────────────╮ │ ☰ Parameter │ → Change │ ℹ Reason │ ├─────────────────────────────────┼─────────────────────────────┼────────────────────────────────────────────┤ │ wall_line_count │ 2 → 3 │ Increase perimeters to 3 to reinforce the │ │ │ │ shell and mounting loops without changing │ │ │ │ geometry. │ ├─────────────────────────────────┼─────────────────────────────┼────────────────────────────────────────────┤ │ infill_density_percent │ 5 → 15 │ Increase infill from 5% to 15% for better │ │ │ │ overall part strength and impact │ │ │ │ resistance. │ ├─────────────────────────────────┼─────────────────────────────┼────────────────────────────────────────────┤ │ nozzle_temp_c │ 220 → 225 │ Slightly increase PLA nozzle temp to 225°C │ │ │ │ to improve layer adhesion while staying │ │ │ │ within recommended range. │ ├─────────────────────────────────┼─────────────────────────────┼────────────────────────────────────────────┤ │ fan_speed_percent │ 100 → 80 │ Reduce cooling to 80% to improve layer │ │ │ │ bonding, while maintaining enough cooling │ │ │ │ for the surface details. │ ├─────────────────────────────────┼─────────────────────────────┼────────────────────────────────────────────┤ │ speeds.wall_inner │ 150 → 100 │ Slow down inner walls to 100 mm/s to │ │ │ │ reduce vibration and improve bonding. │ ╰─────────────────────────────────┴─────────────────────────────┴────────────────────────────────────────────╯ ╭ ★ Strategy ──────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ ❯ Settings biased towards strength: more perimeters and infill, higher temperature, reduced cooling, and reduced │ │ speeds on critical sections for better layer adhesion. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ╭──────────────────────────────────────────────────╮ │ ✔ Optimized project written to test-ny.3mf │ ╰──────────────────────────────────────────────────╯ | Flag | Description |
|---|---|
--output <file> | Specify the output filename (default: *.optimized.3mf). |
--force | Allow the AI to overwrite settings you manually changed in the slicer. |
--verbose | Show the full prompt and JSON payload sent to the AI. |
--mock-response <file> | Use a saved JSON response instead of calling the API (for testing). |
- Parses: Extracts printer info, filament data, and current settings from the
.3mfarchive. - Analyzes: Sends a summary and plate previews to the LLM.
- Optimizes: The AI suggests specific setting changes based on your goal.
- Applies: Updates the configuration files inside the archive.
- Saves: Writes a new
.3mffile. Geometry is never touched.
# Install dependencies npm install # Run tests npm test # Lint code npm run lintNote: This tool is experimental. Always preview the sliced file in Bambu Studio before printing.
