The Engineers Codex

This repository is an AI and Agent learning workspace.

• Current learning focus: AI/LLM/Agent systems, with TypeScript kept only as supporting tooling for Agent work.

• Active checkpoint: B2/01-typescript-basic/index.ts is the current support exercise for typed data and basic TS mechanics.

• brew manages machine-level tools and applications.

• mise manages non-Python runtimes like Node, Go, and Java.

• uv is the only Python workflow for this repository.

Python Workflow

Use the repository root as the shared Python workspace for scripts, exercises, and small experiments.

cd /Users/fpsmeimei/Projects/The_Engineers_Codex
uv sync
uv run python path/to/script.py
uv add <package>
uv add --dev <package>
uv run pytest
uv run ruff check .

Do not use:

• pip install
• python -m venv
• system python3

When To Create A Nested Python Project

If a subdirectory grows into a real standalone app with its own dependencies, initialize a separate uv project inside that folder instead of stuffing every dependency into the repository root.

Use the root project for:

• shared learning scripts
• course exercises
• quick experiments

Use a nested project for:

• a standalone Flask app
• a dedicated API service
• a script collection with its own locked dependencies