目次 / はじめに
はじめに(準備の全体像)
Pixubus EX は すべてあなたの PC の中で動きます。用意するのは3つ — アプリ本体、頭脳の llama.cpp、それに読ませる モデル。このページで全体像をつかんでから、各ページへ進みます。
必要なもの
1
アプリ本体 + Node.js 24+
required- Node.js 24 以上(履歴 DB に Node 組み込みの SQLite を使用)。
- 配布物(zip)を展開したフォルダ。
2
llama.cpp(llama-server)
required- OS に合わせて入手(同梱していません)。
- → llama.cpp の準備(OS別)
3
Gemma4 モデル + mmproj
required- GGUF 本体と mmproj の 2 ファイル。
- → モデルの入手と設置
アプリの起動
配布物を展開したフォルダで、次を順に実行します。
npm ci # 依存をインストール(初回 / 更新後・lockfile 通り)
npm start # サーバー起動 → http://localhost:3020起動したら、ブラウザで http://localhost:3020 を開きます。
※ 開発時(コードを編集して試す場合)は npm install → npm run dev。Vite(:5193)と サーバー(:3020)が立ち上がり、開くのは http://localhost:5193 です。起動直後の数秒、ターミナルに ECONNREFUSED が出ることがありますが、両方そろえば消えます(正常)。
ポートは
PORT 環境変数で変えられます(例 PORT=5030 npm start)。サーバーは 0.0.0.0 で待ち受けるので、同じネットワークのスマホや別 PC から http://<PC の IP>:3020 でも開けます。
認証はありません。 LAN や Tailscale など、信頼できるネットワーク内でのみ使ってください。インターネットに直接公開しないこと。
初回の設定
起動できたら、画面右上の 「設定」を開いて LLM(llama-server)を登録します。やり方は2モード。
- managed(おすすめ) —
llama-serverのパスとモデル(GGUF / mmproj のパス)を登録すると、アプリが起動・モデル切替まで面倒をみます。 - connect — 自分で起動した
llama-serverの URL につなぎます。別 PC・クラウド GPU も可。
各項目の意味と調整は 設定(LLM 接続) に詳しくあります。
managed を使うときは Ollama を止めておく(同じ GPU の VRAM を奪い合うため)。
ollama ps が空であることを確認してください。