selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
Tracefinity logo

Self-host Tracefinity

0.10.1

AI-powered gridfinity bin generator from tool photos

BetaOpen SourceMIT
Updated11 hours ago
LanguagePython
Setup difficultyModerate
ThemeDark mode
Stars
721
CPU
AVX-capable x86-64 or ARM64
RAM
2GB (IS-Net), 6GB (InSPyReNet), 8GB (BiRefNet Lite)
Storage
1GB+ free for personal library
Port
3000 (HTTP web interface)
Docker
ghcr.io/tracefinity/tracefinity
Install with Docker
Dashboard showing tool library and bin listTool editor with outline editing and cutout controlsBin editor with drag-and-drop layout and 3D preview

What is Tracefinity?

Tracefinity is a self-hosted web application that creates custom gridfinity storage bins from photos of tools. Users place tools on standard paper sizes, photograph them, and AI traces tool outlines automatically using local models (IS-Net, BiRefNet Lite, InSPyReNet) or cloud APIs (Google Gemini, Replicate, fal.ai). Traced tools are saved to a library, organized into projects, and arranged in a bin editor with snap-to-grid layout. Features include finger holes, interior rings for hollow tools, cutout clearance and chamfer, contrast inserts for multi-color printing, text labels, live 3D preview, and automatic bed splitting for large bins. Exports include STL, 3MF (multi-color), and SVG. The application runs in a single Docker container with data in one volume, works on both AMD64 and ARM64 architectures, and requires at least 2GB RAM for the default IS-Net model. Authentication is built-in with 2FA support, and an optional Ollama or OpenRouter integration can auto-name tools.

Should you self-host Tracefinity?

Tracefinity scores 51/100 on selfhost.directory (how scoring works) and ranks #12 of 22 in 3D Printing. It has 721 GitHub stars.

It shipped 10 stable releases in the past year. The latest, 0.10.1, came out on 24 October 2026. New versions land roughly every 10 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Octoprint (73/100, 9 167 stars). It scores higher overall, so compare the two before you pick. See Tracefinity vs Octoprint side by side.

Features

  • AI-powered tracing
  • Bin builder
  • Bin projects
  • Contrast insert
  • Cutout chamfer
  • Cutout clearance
  • Finger holes
  • Gridfinity compatible
  • Interior rings
  • Manual mask upload
  • Selective saving
  • Smooth or accurate curves
  • Text labels
  • Tool editor
  • Tool Library

Tracefinity README

How to install Tracefinity

Install Tracefinity with Docker

Environment variables
GOOGLE_API_KEY, FAL_KEY, REPLICATE_API_TOKEN, TRACERS, MAX_UPLOAD_MB, MAX_IMAGE_PIXELS, STL_GENERATION_CONCURRENCY, STL_RETENTION_HOURS, TRACEFINITY_ONNX_PROVIDER, GEMINI_IMAGE_MODEL, TOOL_LABEL_PROVIDER, SHOW_APP_VERSION, AUTH_MODE, AUTH_SECRET, AUTH_COOKIE_SECURE, AUTH_COOKIE_DOMAIN, PROXY_SECRET

docker run -p 3000:3000 -v ./data:/app/storage ghcr.io/tracefinity/tracefinity

Supports linux/amd64 and linux/arm64. ARM devices need at least 2GB RAM.

How to configure Tracefinity

  • AUTH_COOKIE_DOMAINhost-onlyAuth cookie domain for subdomain topologies

    Auth cookie domain for subdomain topologies

  • AUTH_COOKIE_SECUREfalseMark the auth cookie Secure. Set true behind TLS

    Mark the auth cookie Secure. Set true behind TLS

    values: true,false

  • AUTH_MODEnativeAuthentication mode: native (cookie login), proxy (trusted reverse proxy, deprecated), or open (no authentication, trusted networks only)

    Authentication mode: native (cookie login), proxy (trusted reverse proxy, deprecated), or open (no authentication, trusted networks only)

    values: native,proxy,open

  • AUTH_SECRETauto-generatedEncrypts 2FA secrets at rest. Auto-generated into the storage volume when unset

    Encrypts 2FA secrets at rest. Auto-generated into the storage volume when unset

  • FAL_KEYfal.ai API key for remote saliency

    fal.ai API key for remote saliency

  • GEMINI_IMAGE_MODELgemini-3.1-flash-image-previewGemini model for mask generation

    Gemini model for mask generation

    values: gemini-3.1-flash-image-preview,gemini-3-pro-image-preview,gemini-2.5-flash-image

  • GOOGLE_API_KEYGemini API key. Uses Gemini instead of local models

    Gemini API key. Uses Gemini instead of local models

  • MAX_IMAGE_PIXELS64000000Maximum decoded pixels accepted before downscaling

    Maximum decoded pixels accepted before downscaling

  • MAX_UPLOAD_MB20Maximum compressed upload size in megabytes

    Maximum compressed upload size in megabytes

  • OPENROUTER_API_KEYRequired for the openrouter provider

    Required for the openrouter provider

  • OPENROUTER_LABEL_MODELgoogle/gemini-2.0-flash-001Model, or comma-separated fallback list, for the openrouter provider

    Model, or comma-separated fallback list, for the openrouter provider

  • OPENROUTER_URLhttps://openrouter.ai/api/v1/chat/completionsChat completions endpoint for the openrouter provider. Any OpenAI-compatible API that accepts image inputs

    Chat completions endpoint for the openrouter provider. Any OpenAI-compatible API that accepts image inputs

  • PROXY_SECRETShared secret for a trusted multi-user reverse proxy (proxy mode)

    Shared secret for a trusted multi-user reverse proxy (proxy mode)

  • REPLICATE_API_TOKENReplicate API token for remote saliency

    Replicate API token for remote saliency

  • SHOW_APP_VERSIONtrueShow the running version in the settings popover

    Show the running version in the settings popover

    values: true,false

  • STL_GENERATION_CONCURRENCYunlimitedProcess-wide maximum STL generation jobs; excess jobs wait up to 5 seconds, then receive 503

    Process-wide maximum STL generation jobs; excess jobs wait up to 5 seconds, then receive 503

  • STL_RETENTION_HOURS24Hours generated STL/3MF/zip exports are kept before a background sweep deletes them; 0 keeps exports forever

    Hours generated STL/3MF/zip exports are kept before a background sweep deletes them; 0 keeps exports forever

  • TOOL_LABEL_MAX_CROP_PX512Maximum long edge for each isolated tool crop (both providers)

    Maximum long edge for each isolated tool crop (both providers)

  • TOOL_LABEL_MODELqwen3-vl:4bOllama vision model used for naming (ollama provider only)

    Ollama vision model used for naming (ollama provider only)

  • TOOL_LABEL_OLLAMA_URLhttp://localhost:11434Ollama server URL (ollama provider only)

    Ollama server URL (ollama provider only)

  • TOOL_LABEL_PROVIDERnoneOptional automatic tool naming: ollama (local vision model) or openrouter (any OpenAI-compatible endpoint)

    Optional automatic tool naming: ollama (local vision model) or openrouter (any OpenAI-compatible endpoint)

    values: none,ollama,openrouter

  • TOOL_LABEL_TIMEOUT_SECONDS30Timeout for each naming request (both providers)

    Timeout for each naming request (both providers)

  • TRACEFINITY_ONNX_PROVIDERautoLocal ONNX provider: auto, cuda, or cpu

    Local ONNX provider: auto, cuda, or cpu

    values: auto,cuda,cpu

  • TRACERSauto-detectedComma-separated list of available tracers, e.g. gemini,birefnet-lite,isnet

    Comma-separated list of available tracers, e.g. gemini,birefnet-lite,isnet

    values: gemini,birefnet-lite,isnet,inspyrenet,birefnet-general

Tracefinity releases & version history

More in 3D Printing

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…