メインコンテンツへスキップ
見出し画像

【第0回】Pythonで「自分専用データ分析アプリ」を作ろう ― シリーズ案内と完成イメージ

    生成AIがユーザーが欲しい動くコードを簡単に生成できる時代になりコードを書くことそのものに価値はなくなってきた一方で作られたコードの意味は何となくでも知っておくべきです。

    そこで私が趣味でよく作っている「データ+AI」をテーマにPythonアプリを作りながら基礎をなんとなく理解するため執筆していきます。

    対象読者: Pythonの基本文法(変数・if・for・関数)を少し触ったことがある人
    このシリーズで作るもの: 趣味のデータを自動で集めて、AIに分析させるWebアプリ
    必要な環境: Python 3.10以上、好きなエディタ(VS Codeを推奨)


    なぜ「アプリを育てながら学ぶ」のか

    Pythonの入門書を最後まで読んだのに、「で、何を作ればいいんだろう?」となった経験はないでしょうか。

    このシリーズは逆の順番で進めます。

    最初に「作りたいもの」を決め、それを動かすために必要な技術だけを、必要な順番で学ぶ。

    題材は「趣味データ自動収集・分析アプリ」。たとえば——

    • 好きなジャンルの新着情報を毎日自動で取得してDB保存

    • 蓄積したデータをもとに「今日のおすすめ」をAIが提案

    • 自分の記録(読書ログ・運動記録・家計など)と組み合わせて分析

    これを12回かけて、ローカルで動くものから実際のクラウド運用まで完成させます。


    完成イメージ:こんなアプリができる

    完成したアプリのざっくりした構成はこうです。

    [Webアプリ(Flask)]
       ├─ トップ:ダッシュボード(今日の概要・AI提案)
       ├─ データ一覧:取得済みデータのテーブル表示
       ├─ 手動入力:自分の記録を追加・編集
       ├─ 自動取得:ボタン一発で最新データを取得
       ├─ AI分析:データを渡してAIに質問・提案させる
       └─ 設定:スケジュール・APIキー管理

    データの流れ:

    公開データ(Web)
        ↓ スクレイピング(第3〜5回)
    SQLiteデータベース(1ファイル)
        ↓
    Gemini API(第7回)
        ↓
    AIからの提案・分析結果
        ↓
    Webアプリの画面に表示

    一度動かしてしまえば、毎日自動でデータが溜まり、朝起きたらAIがレポートを生成している——そういうアプリです。


    全12回の構成

    🟦 基礎フェーズ(第0〜2回):まず画面を出してデータを保存する

    • 第0回 シリーズ案内・完成イメージ / 環境構築・Hello Flask ← この記事

    • 第1回 Flaskで画面を出す / ルーティング・Jinja2テンプレート

    • 第2回 SQLiteに記録を残す / CRUD・スキーマ設計

    🟨 データ取得フェーズ(第3〜6回):ネット上のデータを自動で集める

    • 第3回 HTMLを読んでデータを取る / urllib・BeautifulSoup

    • 第4回 サイトごとの"癖"に対応する / Cookie・文字コード・JSON/ZIP

    • 第5回 ブラウザ必須サイトの突破 / Playwright

    • 第6回 長い処理をタイムアウトさせない / バックグラウンドジョブ・進捗表示

    🟥 AI・自動化フェーズ(第7〜9回):AIに判断させて自動で動かす

    • 第7回 AIにデータを渡して判断させる / Gemini API・プロンプト設計

    • 第8回 「提案が当たったか」を測る / データ突合・精度集計

    • 第9回 定期実行で自動化する / APScheduler

    🟩 運用フェーズ(第10〜11回):クラウドで24時間動かし続ける

    • 第10回 クラウドに載せる(月0円運用) / GCP・systemd

    • 第11回 IP制限を自宅回線で回避する / 中継エージェント・認証

    第3〜5回(スクレイピングの実務)と第7〜8回(AI活用)がこのシリーズならではのパートです。教科書には載っていない「実際のサイトを相手にしたときの対処法」を、実際にハマったエラーを含めて書いていきます。


    環境構築

    1. Pythonのインストール確認

    ターミナル(WindowsならコマンドプロンプトまたはPowerShell)で確認します。

    python --version
    # または
    python3 --version

    `Python 3.10.x` 以降が表示されればOKです。入っていない場合は python.org からインストールしてください。

    2. 仮想環境を作る

    プロジェクト専用の環境を作ることで、他のプロジェクトと依存関係が混ざるのを防ぎます。

    # プロジェクトフォルダを作成
    mkdir my-data-app
    cd my-data-app
    
    # 仮想環境を作成・有効化
    python -m venv .venv
    
    # Mac/Linux
    source .venv/bin/activate
    
    # Windows
    .venv\Scripts\activate

    プロンプトの先頭に `(.venv)` と表示されれば有効化できています。

    3. Flaskをインストール

    pip install flask


    画像
    実際のコマンド実行例 ※ 環境はMacBook

    Hello, Flask ― まず動かしてみる

    理屈より先に動かします。以下を `app.py` として保存してください。

    from flask import Flask
    
    app = Flask(__name__)
    
    @app.route('/')
    def index():
        return '<h1>Hello, Flask!</h1><p>アプリ起動成功です。</p>'
    
    if __name__ == '__main__':
        app.run(debug=True)

    実行します。

    python app.py

    こんなメッセージが出れば成功です。

     * Running on http://127.0.0.1:5000
     * Debug mode: on

    ブラウザで `http://127.0.0.1:5000` を開いてください。「Hello, Flask!」が表示されるはずです。

    画像
    参考画像

    コードの読み方

    from flask import Flask          # Flaskライブラリの読み込み
    
    app = Flask(__name__)            # アプリ本体の作成
    
    @app.route('/')                  # 「/」にアクセスしたときの処理を登録
    def index():
        return '<h1>Hello</h1>'     # ブラウザに返す内容
    
    if __name__ == '__main__':
        app.run(debug=True)          # 開発用サーバーを起動

    `@app.route('/')` が「どのURLにアクセスしたときに、この関数を実行するか」を決める部分です。これをルーティングと呼びます。次回、ここを詳しく掘り下げます。

    `debug=True` はコードを変更したときに自動でサーバーが再起動する開発用の設定です。本番環境では外します。


    つまずきポイント集

    `ModuleNotFoundError: No module named 'flask'`

    仮想環境を有効化せずにPythonを実行しているケースがほとんどです。

    # これを忘れずに(Mac/Linux)
    source .venv/bin/activate
    
    # 有効化できているか確認
    which python
    # → /path/to/my-data-app/.venv/bin/python と出ればOK

    `Address already in use` エラー

    5000番ポートが別のプロセスで使われています。

    # 使用中のプロセスを確認・終了(Mac/Linux)
    lsof -i :5000
    kill -9 <PID>

    または `app.run(port=5001)` で別のポートを指定してもOKです。

    ブラウザを閉じてもサーバーが止まらない

    `debug=True` モードではターミナルを閉じるまでサーバーは動き続けます。終了するには Ctrl + C を押してください。


    演習:自分の題材で Hello World

    今回作ったアプリは「アプリのジャンル」を宣言しただけです。次の演習で自分化しましょう。

    ミッション:`index()` 関数の返り値を、自分が作りたいアプリのトップページっぽい内容に変えてみてください。

    たとえば読書ログアプリなら:

    @app.route('/')
    def index():
        return '''
        <h1>📚 読書ログアプリ</h1>
        <p>今月読んだ本: 3冊</p>
        <p>AIのおすすめ: 「プロジェクト・ヘイル・メアリー」</p>
        '''
    画像
    参考画像
    画像
    参考画像

    ※ HTMLを直接 `return` するのはわかりやすいようにこの回の最初だけあえてこうしています。次回からはテンプレートファイルに分離します。


    AIチューターへの質問例

    困ったときはAIチューター(ChatGPT/Claudeなど)に聞くのが最速です。
    こんな聞き方が効果的です。

    「Flask初心者です。`python app.py` を実行すると次のエラーが出ます。原因と解決策を教えてください:[エラーメッセージを貼り付け]」

    「`@app.route` の役割を、飲食店の「受付窓口」に例えてわかりやすく説明してください」

    ポイント:エラーメッセージは必ず全文コピーして貼ります。「エラーが出ました」だけでは回答の精度が落ちます。


    次回予告

    第1回:Flaskで画面を出す

    `return '<h1>Hello</h1>'` でHTMLを直書きするのは今回限りです。次回からは テンプレートファイル(Jinja2) を使って、画面とロジックを分離します。

    • URLごとに違うページを表示する(ルーティング応用)

    • HTMLファイルをテンプレートとして使う(Jinja2)

    • Pythonのデータを画面に渡す(変数・リスト)

    • 入力フォームの土台を作る

    最後まで読んでいただきありがとうございました。

    「Hello, Flask!」が表示できたあなたは、もう立派なスタートラインに立っています。次回は画面をもう少し"アプリらしく"整えていきます。ぜひ引き続きお付き合いください!

    もし詰まったところや「ここをもっと詳しく」があれば、コメントで教えてもらえると次回以降の参考にします。

     
     
    はじめまして。本業はITインフラエンジニアをしています。 ITテクノロジーの知見から、生成AIによる創作活動、日常の雑談まで、「誰かのヒントになる」をテーマに幅広く投稿していきます。フォローやスキをいただけると励みになります!

    あなたへのおすすめ