How ieee-blackbox-ai/blackbox-ai-participant-template works
This is a team template for investigating a black-box system across four rounds, documenting evidence, and submitting findings; the final round focuses on reconstructing a surrogate. The shared Python client lets teams inspect their challenge and quota, query the system, and export accumulated data. Edges reflect README workflow statements and calls visible in src/blackbox.py; round-specific internals are represented only by their documented layout.
Main entry points: blackbox.py Blackbox client · round-1/README.md Observe · round-2/README.md Investigate · round-3/README.md Break
Components 17
Investigation rounds
- Observe
round-1/README.md - Investigate
round-2/README.md - Break
round-3/README.md - Reconstruct
round-4/README.md - Final Unknown
final/README.md
Team artifacts
- Findings
round-1/findings.json - Round reports
round-1/report.md - Experiments and plots
round-1/experiments - Investigation issues
.github/ISSUE_TEMPLATE - Round submission
.github/PULL_REQUEST_TEMPLATE.md
API client
- Blackbox client
src/blackbox.py - Challenge spec
src/blackbox.py - Query system
src/blackbox.py - Quota and export
src/blackbox.py - Leaderboard
src/blackbox.py
Other components
- Team
- Competition API
Connections 20
- Team → Observe: starts with
README.md - Observe → Investigate: continues to
README.md - Investigate → Break: continues to
README.md - Break → Reconstruct: continues to
README.md - Team → Final Unknown: submits final
README.md - Team → Findings: records claims
README.md - Team → Round reports: explains evidence
README.md - Team → Experiments and plots: runs and plots
README.md - Team → Investigation issues: opens investigation
README.md - Team → Round submission: submits round
README.md - Team → Blackbox client: uses
README.md - Blackbox client → Challenge spec: requests
src/blackbox.py - Blackbox client → Query system: sends inputs
src/blackbox.py - Blackbox client → Quota and export: requests
src/blackbox.py - Blackbox client → Leaderboard: requests
src/blackbox.py - Challenge spec → Competition API: calls
src/blackbox.py - Query system → Competition API: calls
src/blackbox.py - Quota and export → Competition API: calls
src/blackbox.py - Leaderboard → Competition API: calls
src/blackbox.py - Reconstruct → Quota and export: uses prior queries
README.md