Directory / brndnmtthws/thetagang

brndnmtthws/thetagang

ThetaGang is an IBKR bot for collecting money

Reviewed Bot 90/100

Not financial advice. A grade measures public repo hygiene only (license, upkeep, tests, paper mode, risk limits, docs). It does not measure returns, safety or suitability. Options trading can lose more than you invest. Read the full policy.

Reviewed. Grok Bot read the code and docs and checked or adjusted each judged factor. Nothing was executed. This is not a human audit. Reviewed on 2026-10-24 against commit 35e66b5, rubric v1.1.

Reviewer summary: The best known open source wheel bot. IBKR only, strong tests and CI, dry-run mode, and documentation that tells users to use a paper account first. Position control comes from margin usage and new-contract limits. It has no kill switch.

Facts

Repository	https://github.com/brndnmtthws/thetagang
Type	Bot
Strategies	The wheel, Covered calls
Brokers	Interactive Brokers
License	AGPL-3.0
Language	Python
Last commit	2026-10-16 (8 days before the scan)
Last scanned	2026-10-24
Stars	2755 (shown for context, never scored)

Score breakdown

Factor	Points	How it was decided
Risk limits and kill switch	10 / 20	margin_usage and maximum_new_contracts_percent limits in the config (10). No kill switch, circuit breaker or approval gate found; process kills in the code only clean up subprocesses. Reviewer adjusted this factor (scanner said 15). Scanner evidence (4, automated, can include false matches) `examples/external_decisions/regime_target_weights.request.json:11` [buying power cap] "margin_usage": 1.0, `docs/external-decisions.md:4` [risk limit] retaining control of validation, risk limits, and order execution. Providers are `thetagang/config_migration/startup_migration.py:87` [human approval] "Legacy config migration requires confirmation, but no TTY is available. " `thetagang/strategies/tail_hedge_engine.py:267` [trading enabled flag] else "trading_disabled"
License	15 / 15	AGPL-3.0 (OSI approved) Reviewer confirmed the scanner result. Scanner evidence (1, automated, can include false matches) `COPYING:1` License file
Last commit on default branch	15 / 15	8 days since last commit Fact from the commit date, no judgment involved. Scanner evidence (1, automated, can include false matches) `default branch HEAD` 2026-10-16 (8 days ago)
Tests	15 / 15	636 test cases found in 33 test files; CI test step found Reviewer confirmed the scanner result. Scanner evidence (4, automated, can include false matches) `tests/test_accounting.py:1` 10 test cases `tests/test_buy_only_percent.py:1` 5 test cases `tests/test_buy_only_relative_threshold.py:1` 6 test cases `.github/workflows/docker-publish.yml:45` - name: Test with pytest
Paper or dry-run mode	15 / 15	documented and code or config switch Reviewer confirmed the scanner result. Scanner evidence (2, automated, can include false matches) `README.md:20` - Exchange-hours enforcement, dry-run validation (`--dry-run`), per-symbol order supervision, and SQLite state/execution tracking `alembic/versions/0001_create_state_tables.py:19` [dry-run flag] sa.Column("dry_run", sa.Boolean(), nullable=False),
README quality	10 / 10	install steps, config or env vars, explains what it does, risk disclaimer, 23686 chars Reviewer confirmed the scanner result. Scanner evidence (2, automated, can include false matches) `README.md:1` README with 23686 characters `README.md:26` ## Risk Disclaimer
Broker detection	10 / 10	Interactive Brokers (deps, code, readme) Reviewer confirmed the scanner result. Scanner evidence (1, automated, can include false matches) `pyproject.toml:15` [Interactive Brokers: deps+code+readme] "ib-async>=2.0.1,<3",
Total	90 / 100	Grades: A 85+, B 70+, C 55+, D 40+, F below.

Grades measure public repo hygiene on the scan date. They say nothing about profits, safety or security. We did not run this code. Full rubric and patterns.

Something wrong?

Report a correction Request removal (maintainers)

Corrections and removals are public GitHub issues. We reply within 7 days and every change is in the repo history. Sponsors get no special treatment: see our policy.

Badge for your README

Once the site has a public address, shields.io can read /badge/brndnmtthws--thetagang.json from it. Badges show the grade and whether it was reviewed. Maintainers may use one without asking.