SoritonLab/tokenomics-quantum-design-agent

Tokenomics Quantum Design Agent MVP

1. このSpaceの目的

本Spaceは、NEDO量子懸賞金事業 S-15 向け研究「量子コンピュータを用いたWeb3トークン経済の設計最適化」の成果を、審査員・実務ユーザーが触れる simulator-only AI agent MVP として提示するためのWebデモです。

Week2〜Week8で構築した以下の研究成果を、Week10で統合しています。

• —Phase 1: 初期トークン配分の候補比較・最適化
• —QAOA simulator: QUBO/Ising問題のサンプリング評価
• —Phase 2: 発行後の循環政策、fixed policy、stress scenario、rolling policy summary
• —Report ZIP: CSV、Markdown、PNG、ZIPをまとめた提出・確認用成果物

2. 重要な前提

このMVPは simulator-only です。

• —IBM Quantum実機は直接呼び出しません。
• —IBM tokenやAPI keyは要求しません。
• —qiskit_ibm_runtime は依存に含めません。
• —量子優位を主張しません。
• —トークン価格予測ではありません。
• —投資助言ではありません。

3. 画面構成

4. ローカル実行

python -m pip install -r requirements.txt
python app.py

または、package moduleとして起動する場合は以下です。

python -m tokenomics_agent.app

5. 再現用CLI

python -m tokenomics_agent.cli phase1 --config configs/sample_phase1_config.json
python -m tokenomics_agent.cli qaoa --config configs/sample_qaoa_config.json
python -m tokenomics_agent.cli phase2 --config configs/sample_phase2_config.json
python week10_status.py --day day6 --write-inventory --validate --run-pytest

6. no-overclaim

本MVPの出力は設計支援のためのスコア比較です。実市場価格の予測、投資判断の保証、量子優位の実証、full48のIBM実機直接最適化を主張するものではありません。

7. Hugging Face Spacesへの実デプロイ

Day6成果物は、Hugging Face Spacesへ配置可能な構成として作成している。実際に外部Spaceへpushするには、ユーザー自身のHugging FaceアカウントとUser Access Tokenが必要である。tokenは成果物に保存しない。

最短手順は以下である。

python -m pip install huggingface_hub
$env:HF_TOKEN="hf_xxx"
python scripts/prepare_hf_space_package.py
python scripts/deploy_hf_space.py --hf-username YOUR_HF_USERNAME --space-name tokenomics-quantum-design-agent --private false
python scripts/validate_hf_space.py --space-url https://huggingface.co/spaces/YOUR_HF_USERNAME/tokenomics-quantum-design-agent

詳細は docs/DAY6_EXTERNAL_DEPLOYMENT_COMPLETION_GUIDE.md と docs/DAY6_HF_PUSH_RUNBOOK.md を参照すること。

Phase 1 customizable mode

This Space includes a customizable Phase 1 tab. Users can select a preference profile, allocation constraints, and objective weight multipliers. The UI displays a JSON config preview that is designed to be shared with the future API/GPT Actions interface.

The natural-language-like prompt box uses a limited rule-based preset mapping, not a full LLM parser. Full natural language handling is planned for the API/GPT Actions layer.