動作環境・前提条件

構成の概要

Yokinsoft Paperlessは、自社サーバーにインストールして運用するオンプレミス型のシステムです。クラウドサービスへの登録は不要ですが、AI分類にGoogle Gemini APIを使用するためインターネット接続が必要です。

サーバー動作環境

本システムはLinuxおよびWindowsの両環境で動作します。いずれのOSでも、Python・Node.jsが動作する環境であれば稼働可能です。

FAX受信環境の前提条件

本システムはFAX受信そのものは行いません。既存のFAX機器・サーバーが受信したファイルをフォルダに保存する機能を利用して連携します。

Google Gemini APIキーの取得

文書のAI自動分類にはGoogle Gemini APIを使用します。APIキーの取得と設定が必要です。

APIキー取得の手順

• Google AI Studio にアクセス

  https://aistudio.google.com/ にアクセスし、Googleアカウントでサインインします。

• APIキーを作成

  画面左メニューの「Get API Key」→「Create API key」からAPIキーを生成します。

• 利用規約・料金を確認

  Google Gemini APIには無償枠（Gemini 1.5 Flash等）があります。利用量によっては有償プランへの移行が必要になる場合があります。料金ページをご確認ください。

• システム設定ファイルに記述

  取得したAPIキーをサーバー側の設定ファイル（.env または db_config.py）に設定します。詳細はINSTALL_MONITORのセットアップ手順を参照してください。

導入前チェックリスト

導入を検討する際に確認しておくべき事項をまとめました。

技術環境

• Linux（Ubuntu 20.04 LTS以降推奨）またはWindows（10/11/Server 2019以降）サーバーが用意できる
• Python 3.10 以上がインストールできる
• Node.js 18.x 以上がインストールできる
• 社員のPC・スマートフォンからサーバーのポート（例: 3000）にアクセスできる
• サーバーからインターネット（Google API）へのHTTPS接続が可能

FAX受信環境

• 受信したFAXをPDF/TIFFとしてフォルダに自動保存できるFAXサーバーがある
• 保存フォルダにPaperlessサーバーからアクセス可能（ローカルまたはマウント）

セキュリティ・情報管理

• FAX文書をGoogleクラウドへ一時送信することについて、社内セキュリティポリシーを確認した
• Google Gemini APIキーを取得できる（Googleアカウントが用意できる）
• Google Gemini APIの利用規約・料金を確認した
• 本システムへのアクセスをLAN内に限定する場合のネットワーク設定を確認した

セットアップの大まかな流れ

詳細な手順は同梱の INSTALL_WEB.md および INSTALL_MONITOR.md を参照してください。ここでは流れの概要を示します。

• リポジトリを取得

  GitHubからソースコードをダウンロードまたはクローンします。

• Node.js 依存パッケージをインストール

  web/ ディレクトリで npm install を実行します。

• Python 依存パッケージをインストール

  monitor/requirements.txt を使って pip install -r requirements.txt を実行します。

• データベースを初期化

  scripts/init_sqlite_db.py を実行してSQLiteデータベースとテーブルを作成します。

• 設定ファイルを作成

  Google Gemini APIキー、FAX受信フォルダパス、その他の環境設定を記述します。

• サービスとして登録・起動

  同梱の .service.sample ファイルを参考に systemd サービスとして登録し、自動起動を設定します。

インストールに必要なスキル

自社のIT担当者やエンジニアが導入する場合のスキル目安をまとめました。プログラミング知識は不要です。定型的なIT担当者レベルで対応できる範囲です。→ Yokinsoftの有償導入支援も選択できます