> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Recommended Python

Use this set for Python projects built around pure transformations, immutable domain values, explicit capabilities, and typed Results. It uses `returns` for failure and composition, with shared rules for engineering decisions and collaboration.

**Pack:** `bytefarm/recommended-python` · **Version:** `0.1.0`

## Install

With the [npm CLI installed](/getting-started/quick-start.md), run from a project beside a checkout of `thebytefarm/granary` named `granary-packs`. The checkout supplies the pack sources; no build is needed:

```sh
granary add file:../granary-packs/packs#recommended-python --output .granary/context/docs/bytefarm
```

## Included packs

This composite installs these five packs in reading order. Open a card to browse that pack's concepts and rules.


[Engineeringbytefarm/engineering — pure domain logic, isolated effects, immutable state, explicit failures, and behavioral tests.](/packs/shared/engineering)[Gitbytefarm/git — scoped commits, focused pull requests, and verification evidence reviewers can trust.](/packs/shared/git)[Documentationbytefarm/documentation — task-oriented writing, portable Markdown, and the right shape for each page.](/packs/shared/documentation)[Agent instructionsbytefarm/agent-instructions — short operating contracts, canonical rules, and task-based context routing.](/packs/shared/agent-instructions)[Functional Pythonbytefarm/python-functional — pure functions, immutable domain values, typed Results with returns, explicit adapters, and composition.](/packs/languages/python)

## Use the installed context

Follow the reference links in root `AGENTS.md`. Read the shared engineering rules first, then the topics relevant to your change. Python rules apply to Python source and examples. The documented `returns` decorator and composition typing uses its compatible mypy plugin; adding dependencies still follows your project's approval rules.

Adding another recommended language set reuses the shared packs. The lockfile pins the source revision and file integrity; `granary install` restores the same context.