PrintWise v0.6.3

PrintWise is a free community tool for 3D printing enthusiasts. It runs locally in your browser, analyzes a model, helps select printer/process/filament settings from the Orca profile library, previews the recommended orientation, and exports Orca-ready starting profiles.

Fast setup on Windows

1. Extract the ZIP.
2. Double-click START_HERE_WINDOWS.bat.
3. Your browser should open to http://127.0.0.1:7880 or the next available local port.
4. Upload a model, or use sample_models/test_10mm_cube.stl.
5. Search/select a printer.
6. Confirm nozzle and build volume.
7. Search/select a compatible process preset, or leave it blank for auto-generated process settings.
8. Choose a filament source:
   • Select/search preset for Orca/library filaments.
   • Import unknown filament for a 3DFilamentProfiles.com import or manual specs paste.
9. Click Analyze + Generate Orca Profiles.

The app works offline by default and has no Python package dependencies. Testers only need Python 3.10+ installed.

Tester release status

This is an early community tester release. Back up important slicer profiles, review every generated setting in OrcaSlicer, and begin with a small calibration print. Please report reproducible bugs and real print outcomes through GitHub Issues; CONTRIBUTING.md explains what information is most useful.

Before reporting a startup problem, run:

python3 app.py --diagnose

Windows users can run Check_System_WINDOWS.bat instead.

Main features

• Local browser-based web app.
• STL / 3MF / OBJ model analyzer.
• 3D preview with recommended orientation.
• Searchable printer picker.
• Process presets filtered by selected printer/nozzle.
• Filament presets filtered by compatibility, with optional show-all mode.
• Mutually exclusive filament preset/import modes to avoid double-selection.
• Unknown filament import from 3DFilamentProfiles.com URL or pasted specs.
• Orca-ready export bundle plus printer/filament/process JSON files.
• Confidence scoring and optimization report.
• Aftermath/failure reporting with optional photo/video/log evidence.
• OpenAI/API enrichment can fail soft back to offline mode when rate-limited.

Included profile library

The bundled library was built from the Orca printer/filament/process profile set provided for this project. Internal inherited base profiles are hidden from tester-facing search while staying available for automatic matching.

Current searchable index after dedupe:

• 1,379 printer profiles
• 5,954 filament profiles
• 2,881 process profiles

Current internal matching library after dedupe:

• 1,463 printer profiles
• 6,664 filament profiles
• 3,278 process profiles

Counts may change after users import additional profiles because custom imports override matching built-in names.

Clean folder layout

PrintWise_v0.6.3/
├─ START_HERE_WINDOWS.bat
├─ Check_System_WINDOWS.bat
├─ Create_Desktop_Shortcut_WINDOWS.bat
├─ Start_PrintWise_Mac_Linux.command
├─ Open_PrintWise.url
├─ app.py
├─ requirements.txt
├─ README.md
├─ CHANGELOG.md
├─ LICENSE.md
├─ NOTICE.md
├─ THIRD_PARTY_NOTICES.md
├─ manifest.json
├─ profile_library/
├─ import_profiles/
├─ sample_models/
└─ runs/

Adding more profiles

Inside the app, use Add profiles without touching folders.

Or manually drop files into:

import_profiles

Then restart the app or refresh templates.

Supported profile imports:

• .orca_printer
• .orca_filament
• .orca_process
• .zip
• .json

Unknown filament workflow

1. Select Import unknown filament.
2. The filament preset picker is disabled to prevent double-selection.
3. Paste a 3dfilamentprofiles.com URL, or paste the filament specs/page text.
4. Click Import filament profile.
5. The app creates a local Orca-style filament JSON, switches back to preset mode, and selects the imported filament.
6. Review temperatures, cooling, flow, and volumetric speed before production prints.

If the URL import is blocked or rate-limited, copy the filament specs from the page and paste them into the manual text box.

Outputs

Each run saves a folder under runs/ with:

• .orca_printer profile bundle
• full output ZIP
• optimized printer/filament/process JSON files
• model analysis JSON
• 3D preview mesh JSON
• confidence score JSON
• optimization report markdown
• import notes

HTTP 429 / rate-limit troubleshooting

HTTP 429 means an external service is asking the app to slow down. In PrintWise this usually comes from one of two optional paths:

1. OpenAI API enrichment — switch Setup mode back to Offline Orca library + heuristics, or wait for the API rate/quota window to reset. PrintWise falls back to offline mode instead of failing the whole run.
2. 3D Filament Profiles URL import — paste the filament specs/page text into the manual text box instead of fetching the URL. Successful URL fetches are cached locally to reduce repeated requests.

Normal model analysis and Orca profile generation are local/offline and should not need any external service.

License / community-use intent

PrintWise is intended to remain free for the 3D printing community.

• Original PrintWise code, UI, docs, workflows, launcher scripts, and branding are covered by LICENSE.md: PrintWise Community Noncommercial License v1.0.
• Keep LICENSE.md, NOTICE.md, and THIRD_PARTY_NOTICES.md with any copy or modified version you share.
• Do not sell PrintWise, put it behind a paywall, host it as a paid service, bundle it into a paid product, or rebrand it as a commercial tool without written permission.
• Third-party materials, including OrcaSlicer profile data and user-imported profiles, keep their own upstream license terms.

This is source-available noncommercial community software, not OSI-approved open-source software.

Important note

PrintWise generates strong starting-point profiles. It does not replace physical calibration. Testers should still slice/preview in Orca and verify first layer, flow, temperature, pressure advance, and speeds for their actual printer and spool.

Contributing and security

• See CONTRIBUTING.md for testing, issue, and pull-request guidance.
• See SECURITY.md for private vulnerability reporting and safe tester practices.
• Generated runs and locally imported profiles are intentionally excluded by .gitignore; inspect and redact any files before attaching them to a public issue.