Skip to content

docs: add VSCode+uv A-to-Z beginner guide; CLI/UI and analysis improvements#13

Merged
rad1092 merged 2 commits into
mainfrom
codex/provide-step-by-step-execution-guide
Feb 13, 2026
Merged

docs: add VSCode+uv A-to-Z beginner guide; CLI/UI and analysis improvements#13
rad1092 merged 2 commits into
mainfrom
codex/provide-step-by-step-execution-guide

Conversation

@rad1092
Copy link
Copy Markdown
Owner

@rad1092 rad1092 commented Feb 13, 2026

Motivation

  • Provide a complete A-to-Z beginner guide that starts from creating a folder in VSCode and covers uv venv creation, activation, install, Ollama setup, CLI and UI usage, and troubleshooting.
  • Improve developer ergonomics for local testing by making pytest runnable without manually setting PYTHONPATH.
  • Add first-class support for building analysis payloads from inline CSV text and make the CLI more flexible to run the UI or legacy analyze mode.

Description

  • Rewrite BEGINNER_README.md into a step-by-step VSCode + uv A-to-Z guide including exact shell commands, activation steps, Ollama setup, CLI/UI flows, troubleshooting, and a completion checklist.
  • Add build_prompt and build_analysis_payload_from_csv_text to bitnet_tools/analysis.py (and import io) and refactor build_analysis_payload to use the new prompt builder.
  • Refactor CLI in bitnet_tools/cli.py to _build_parser/main, add a ui subcommand that delegates to serve, support legacy positional analyze invocation, and keep optional immediate ollama run execution via --model.
  • Export the updated analysis API from bitnet_tools/__init__.py, add pythonpath = ["."] to [tool.pytest.ini_options] in pyproject.toml, and add/update tests in tests/test_analysis.py and new tests/test_cli.py.

Testing

  • Ran pytest -q and the suite completed successfully with 5 passed.
  • Ran python -m bitnet_tools.cli --help which printed CLI usage and exited successfully.
  • The added CLI and analysis tests (tests/test_cli.py, expanded tests/test_analysis.py) were included in the test run and passed.

Codex Task

@rad1092 rad1092 merged commit dd5bcf4 into main Feb 13, 2026
4 checks passed
@rad1092 rad1092 deleted the codex/provide-step-by-step-execution-guide branch February 13, 2026 14:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant