画像アノテーション WebUI + Lambda API
公開サイト: GitHub Pages。初回のみ有効化が必要です。
- 自分の公開URL:
https://<owner>.github.io/<repo>/- GitHub → Settings → Pages に表示されるURLを使用してください。フォーク/別ownerのリポジトリでは公開URLが変わります。
- 初回のみ Pages を有効化する必要があります。手順は
docs/GETTING_STARTED.mdの 1.1 を参照してください。
- 作者運用のデモサイト: https://uchimanajet7.github.io/annoforge/
- UIの動作比較用です。
本リポジトリのコマンド例は、原則としてリポジトリルートでの実行を前提とします。この README があるディレクトリです。
AnnoForge は、WebUIで定義した線・矩形・多角形・平行四辺形・円のアノテーションを、Python 3.13 と SnapStart を使う AWS Lambda 上の API で画像に描画し、S3へ保存してpresigned URLを返すツールです。
- 画像の読み込み: 「画像を選択」またはキャンバスへドラッグ&ドロップ。既存画像は置換されます。
- ツール: 選択/矩形/直線/多角形/平行四辺形/円。
- 直線は
hitStrokeWidth拡大で掴みやすく調整済み。 - 多角形はクリックで頂点追加、ダブルクリック/Enter で確定。
- 平行四辺形は P1→P2→P3 を指定します。P4 は自動補完され、保存順は [P1,P2,P4,P3] です。
- 円は中心クリック→ドラッグで半径→離して確定。変形は等倍。
- 直線は
- 表示操作: 右下の＋/−/リセット、選択ツール中は背景ドラッグでパン。タッチはピンチズーム。
- 色: パレットまたはカラーピッカー。新規作図へ適用します。既定太さは 5px です。
- JSON/入出力: 常時更新。コピー/ダウンロード/インポートに対応します。貼付/ファイル/ドロップで取り込めます。
- 保存: 「注釈付き画像を保存」でPNG出力。
- 対話。推奨です。既定は profile で、プロファイル選択UIがあります。
bash scripts/deploy/with_aws.sh -- bash scripts/deploy/deploy.sh
- 固定プロファイル
bash scripts/deploy/with_aws.sh --mode profile --profile <WORK_PROFILE> -- bash scripts/deploy/deploy.sh
- スモーク。POST→presignedUrl→GET 200 で確認します。
bash scripts/deploy/with_aws.sh -- bash scripts/deploy/smoke.sh
関連ドキュメント
- デプロイ手順・トラブルシュート:
docs/DEPLOY.md - 仕様: 構成/ラッパー仕様/API は
docs/SPEC.md - バージョン運用:
docs/VERSIONS.md - はじめに: UI と Pages の初回有効化を含みます。
docs/GETTING_STARTED.md
- 既定は
profileです。AWS CLI v2 プロファイル/SSO/role_arn+source_profile を使います。自動更新・一時認証に整合します。 - 例外として
authを残置します。AssumeRole+MFA の手動フローです。プロファイルを置けない/使えない、緊急の“その場運用”などでのみ使用します。
ツール導入: 参考
- Terraform: https://developer.hashicorp.com/terraform/install
- AWS CLI v2: https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html
構成仕様・API仕様は docs/SPEC.md にまとまっています。
- 開発者向けのローカルセットアップとCI相当チェック手順:
docs/DEV_SETUP.md - 例: Shell/Bash 検査と Terraform 整形チェック
bash scripts/tools/lint_shell.sh --strict
bash scripts/tools/fmt_terraform.sh --check
- はじめに:
docs/GETTING_STARTED.md