app.pyという小さな中心部

はじめに

前回の記事では、DOLL.PKG Studio Consoleのシステム概要をご紹介しました。

生成AIによる創作環境は、以前とは大きく変化しています。

ボタンを押せば画像が生成される。
それだけを見ると、とてもシンプルに感じます。

しかし、ローカルな環境において、その裏側では「どのモデルを使用したのか」「どれくらいの時間をかけたのか」「現在コンピューターはどのような状態なのか」「生成した作品はどこに保存されているのか」・・・

さまざまな情報が動いています。
完成した一枚の作品だけを見るのではなく、その作品が生まれる過程にも目を向ける。

それがDOLL.PKG Studio Consoleを作り始めたきっかけでした。

今回からは、実際のソースコードを見ながら、この小さな制作環境がどのように構成されているのかを紹介します。

最初に取り上げるのは、システム全体の中心となる app.py です。

app.pyは制作環境の「司令塔」

プログラムというと、複雑な計算を行う場所を想像するかもしれません。

しかし、app.pyの役割は少し違います。app.py自身がすべての処理を担当するのではありません。必要な情報を、それぞれ専門の役割を持つプログラムへ依頼し、その結果を利用者へ届ける。それがapp.pyの役割です。

例えるなら、映画制作における監督のような存在です。
監督自身がすべてのカメラ操作や編集作業を行うわけではありません。それぞれの専門スタッフと連携し、一つの作品を完成へ導きます。

DOLL.PKG Studio Consoleにおいて、app.pyはその中心となる存在です。

最初に行う「必要な道具の準備」

app.pyの冒頭には、以下の記述があります。

from flask import (
    Flask,
    jsonify,
    render_template,
    send_file,
)

これは、プログラムで使用する機能を準備している部分です。

例えるなら料理を始める前に、包丁や鍋を用意するようなものです。
このプログラムでは必要な道具を最初に読み込んでおくことで、その後の処理をシンプルに記述できる形にしています。

ここでは、4つの機能を利用するようにしています。

Flask

Flask

Flaskは、PythonでWebアプリケーションを作るための仕組みです。
ブラウザからアクセスされた時に「どの画面を表示するのか」「どの情報を返すのか」を管理します。

app.pyでは、次のように使用されています。

app = Flask(__name__)

ここで「このPythonファイルを中心にWebアプリケーションを作ります」という宣言をしています。この一行によって、ブラウザからアクセスできる仕組みの土台が作られます。

建物で例えるなら、土地を確保し、建物を建てる準備をする段階です。

画面を表示する仕組み

render_template

これは、ブラウザに表示する画面を読み込むための機能です。

Pythonのプログラムは、そのままでは人間が見る画面にはなりません。そこでHTMLという画面データを利用します。render_templateは「プログラムの世界」と「利用者が見る画面」をつなぐ橋のような役割を持っています。

例えば、

@app.route("/")
def index():
    return render_template("index.html")

という処理があります。

ここでは、/ （Webサイトの「ルートディレクトリ（トップページ）」）というURLへアクセスされた場合は、templates/index.html を表示します。つまり、Pythonで作られた内部処理と、人間が操作する画面をつなぐ役割をしています。

API（異なるソフトウェアやプログラム同士をつなぐ接点）を作る

次は、

jsonify

です。

少し難しく感じるかもしれませんが、簡単に言えば「プログラム内部の情報を、別の場所へ渡しやすい形に変換する機能」になります。

コンピューター内部では、さまざまな情報が存在します。しかし、その情報をそのまま画面へ渡すことはできません。そこで、情報を決められた形式へ整えて渡します。その役割を担うのがjsonifyです。

DOLL.PKG Studio Consoleでは、システム状態やイベント情報をブラウザへ渡す際に利用しています。

app.pyには、次の処理があります。

@app.route("/api/dashboard")
def api_dashboard():
    """V12 consolidated endpoint: telemetry and events in one request."""
    return jsonify({
        "system": build_system_data(),
        "events": get_events(),
    })

ここは、DOLL.PKG Studio Consoleの中心的な部分の一つです。
システム情報やイベント情報をまとめ、ブラウザ側へ渡しています。

コンピューター内部では、

• CPU使用率

• メモリ使用量

• GPU状態

• 制作状態

など、多くの情報が存在しています。

しかし、それらをそのまま画面へ渡しても、人間が確認できる形にはなりません。build_system_data()という関数を呼び出すことで「現在の制作環境はどのような状態なのか」という情報を取得し、ダッシュボードで利用できる形に整えています。

また、get_events()はシステムの中で発生した出来事を管理する役割です。例えば、制作環境の変化や処理履歴など、時間の流れを記録するために利用されます。

jsonifyは、このように色々取得した情報を整理して届ける翻訳役です。
app.pyがすべてを知っているのではなく、それぞれ専門の処理へ任せる設計にしています。

作品を表示するsend_file

今回のStudio Consoleで、創作部分と直接関係する機能があります。

send_file

app.pyでは、画像ファイルをブラウザへ返す処理で利用されています。これは、保存されているファイルをブラウザへ送るための機能です。

Studio Consoleでは、制作した画像などのファイルを表示するために利用されます。単なる監視システムではなく「制作したものを見る」ための環境でもあるので、この機能は重要な役割を持っています。

例えば、

return send_file(
    latest_artwork_path
)

という形です。

これは「保存されている画像ファイルを、ブラウザで表示できるように渡す」という処理です。

一見すると単純な一行ですが、制作環境においては重要です。
生成した作品は、保存されているだけでは意味がありません。

・必要な時にすぐ確認できること
・制作の流れの中で作品へアクセスできること

そのための小さな橋がsend_fileです。

すべてを一つに書かない理由

app.pyを見ると、意外にも多くの処理はここには存在しません。

・システム情報を作る処理
・イベントを管理する処理
・作品情報を扱う処理
・etc

それぞれ役割ごとに分けられています。
これは、長く使い続けるための設計です。一つの場所にすべてを書き込むと、最初は簡単でも、成長した時に管理が難しくなります。

創作でも同じです。一枚の作品は、キャラクター、色、光、構図、世界観。さまざまな要素が組み合わさって完成します。

プログラムもまた、小さな役割を持った部品が集まり、一つの環境を作っています。

次回予告

次回は、app.pyから呼び出されている内部モジュール、

monitor.system

について解説します。

コンピューター内部の情報をどのように取得し、Studio Consoleへ届けているのか。普段見ることのできない「機械の状態」を、どのように作品制作の環境へ取り込んでいるのか。

実際のコードを読みながら紹介します。

⚠️ソースコード公開に関する注意事項

今回の記事でご紹介した app.py のソースコードを共有いたします。
内容としては、Flaskを利用したシンプルな構成ではありますが、実際に動作させながら試行錯誤を重ね、DOLL.PKG Studio Consoleとして組み上げたものです。

また、安易な転載やそのままの転用を避けるため、ソースコードの公開については有料記事とさせていただきます。

本記事で紹介しているソースコードは、DOLL.PKG Studio Consoleの開発過程を共有し、生成AIを活用した創作環境づくりの一例として公開するものです。

公開しているコードは、ご自身の環境で学習・検証される目的でご利用いただければ幸いです。

⚠️本ソースコード単体ではシステムは動作しません⚠️

あらかじめご了承願います。なお、本ソースコードを利用したことによって発生した、

• システム上の問題

• データ消失

• 環境設定による不具合

• その他の損害

について、一切の責任を負いません。

また、本ソースコードは特定の環境で制作・検証したものであり、すべての環境で動作することを保証するものではありません。ご利用になる場合は、ご自身の環境や目的に合わせて内容を確認し、必要に応じて修正・調整を行ってください。

本ソースコードに関する個別の導入支援、環境構築支援、動作保証、技術サポートは行っておりません。プログラムは、使用する環境やライブラリの違いによって動作が変化する場合があります。

その点をご理解いただいた上で、自己責任のもとご利用ください。

⚠️ Notice Regarding Source Code Release

I am sharing the source code of app.py introduced in this article.

Although the implementation itself is a relatively simple structure using Flask, this code was developed as part of the DOLL.PKG Studio Console project through repeated testing, experimentation, and refinement in an actual working environment.

To prevent unauthorized redistribution or direct reuse without understanding the original purpose and structure, access to this source code is provided as part of a paid article.

The source code presented in this article is intended to share the development process of DOLL.PKG Studio Consoleand to provide an example of how a creative environment utilizing generative AI can be constructed.

You are welcome to use this code for your own learning, experimentation, and technical research within your personal environment.

⚠️ Important Notice: This Source Code Alone Does Not Make the System Functional ⚠️

Please understand that this source code cannot operate as a complete system by itself.

The following issues may occur depending on your environment, configuration, or usage conditions:

• System-related problems

• Data loss

• Configuration errors

• Other unexpected damages or issues

I assume no responsibility or liability for any problems or damages resulting from the use of this source code.

Furthermore, this source code was developed and tested in a specific environment. Therefore, I do not guarantee that it will operate correctly in all environments.

If you choose to use this source code, please review the contents carefully, adapt it to your own environment and objectives, and make any necessary modifications or adjustments.

Technical Support and Usage Disclaimer

Individual support for:

• Installation assistance

• Environment setup

• Operational verification

• Technical troubleshooting

is not provided for this source code.

Please note that program behavior may vary depending on differences in operating systems, installed libraries, versions, and configuration settings.

By using this source code, you acknowledge and accept these conditions and agree to use it at your own responsibility.