Skip to content

APP-97: Fix Truffile setup and inference guidance#6

Open
temp-deepshard wants to merge 1 commit into
deepshard:mainfrom
temp-deepshard:codex/app-97-agent-docs
Open

APP-97: Fix Truffile setup and inference guidance#6
temp-deepshard wants to merge 1 commit into
deepshard:mainfrom
temp-deepshard:codex/app-97-agent-docs

Conversation

@temp-deepshard

@temp-deepshard temp-deepshard commented Jul 16, 2026

Copy link
Copy Markdown

Why

An agent following the docs literally hit avoidable failures: the uv path invoked a missing pip, the inference flag was stale, raw inference lacked host discovery and Python examples, and scripted deletion was unsafe.

Changes

  • uses uv pip --python .venv/bin/python for uv environments
  • uses the virtual environment's Python directly for the standard venv fallback
  • verifies the installed CLI through .venv/bin/truffile
  • documents device-host discovery and a minimal Python httpx inference client
  • corrects --no-tools to --no-default-tools
  • documents foreground, background, and hybrid app creation
  • changes deletion to list, dry-run, human confirmation, and explicit --yes

Validation

  • exact pushed commit fcdedfe832f8150aed4d48aebd80cb56d17b5473
  • official Mint strict validation passed
  • Python inference example parses
  • command examples match the isolated Python 3.12 wheel test
  • APP-96's real private-source wheel build and fresh-install verification passed in run 29476643574
  • automated CI: none configured in this docs repository; validation was run manually

Depends on: deepshard/truffile#46 and deepshard/truffile#47

Followed by: #5

Linear: APP-97

@temp-deepshard
temp-deepshard marked this pull request as ready for review July 16, 2026 06:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant