EMSUGI

えむすぎ

目次

• プロジェクト概要
• 主な特長
• スクリーンショット
• はじめる
  • 技術スタック
  • インストール
  • Docker で実行する
  • フォルダー構造
• 使用法
• 貢献する
• MITライセンス

プロジェクト概要

EMSUGIは、さまざまなソースから緊急警報を収集して分析するように設計された洗練されたアプリケーションです。生成 AI を活用して、過去のデータと現在の傾向に基づいて将来のインシデントを予測します。このシステムは、洞察力に富んだレポートと視覚的な分析を提供することで、緊急対応の効率を高めることを目的としています。

このプロジェクトが気に入ったら、このリポジトリにスターを付け、貢献したい場合はフォークすることを忘れないでください。皆様のご貢献とご支援に感謝いたします。

主な特徴:

• リアルタイム警報監視: さまざまな国の緊急警報を取得して保存します。
• 生成 AI : AI を実装して、緊急事態の将来予測を分析および生成します。
• グラフィカルな表現: チャートやグラフを使用してデータを表示し、ユーザーが主要な指標を視覚化できるようにします。
• インタラクティブな日付/時刻範囲の選択: ユーザーがレポート生成のカスタム日付と時刻範囲を設定できるようにします。
• キーワードとトピックの分析: 国と地域ごとに人気のキーワードとトピックを特定します。
• レスポンシブ デザイン: レポートを表示するためのモバイル対応のレスポンシブ レイアウトをサポートします。

注:これらの機能はプロジェクトの将来の意図に基づいているため、実際のパフォーマンスと機能はアクティブな開発段階により異なる場合があります。

スクリーンショット

以下は、システムの機能とレイアウトを示すいくつかのスクリーンショットです。

注:これらのスクリーンショットはプロジェクトの開発の現在の状態を反映しており、機能の進化や改善に応じて将来変更される可能性があります。

はじめる

技術スタック:

• Python (バージョン 3.x 以降): バックエンド開発に使用される強力な高レベル プログラミング言語。
• Flask : Python で Web アプリケーションを構築するための軽量の Web フレームワーク。
• pandas : データ分析のための強力なデータ構造を提供するデータ操作ライブラリ。
• matplotlib : 静的、アニメーション化されたインタラクティブなビジュアライゼーションの作成に使用される一般的なプロット ライブラリ。
• gemini : AI を活用した生成レポート生成ツール。緊急レポートや災害レポートの作成に使用されます。
• torch : 機械学習モデル、特にローカル モデル推論のトレーニングとデプロイのための柔軟で効率的なツールを提供する深層学習フレームワーク。
• Transformers : 事前トレーニングされたトランスフォーマーやその他の最先端の機械学習モデルを操作するための Hugging Face によるライブラリ。
• logly : アプリケーション内のログを追跡および管理するために使用されるロギングおよび監視ツール。
• python-dotenv : 環境変数を管理するツール。これにより、 .envファイルで機密情報 (API キー、トークンなど) を構成できるようになります。
• SQLite : アプリケーションのデータを保存および取得するための軽量のディスクベースのデータベース。
• Tailwind CSS : 応答性の高い最新の Web インターフェイスを迅速に設計するためのユーティリティファーストの CSS フレームワーク。
• Font Awesome - UI にスケーラブルなベクター アイコンを追加するために使用されるアイコン ライブラリ。
• Chart.js - データ視覚化のためのインタラクティブでカスタマイズ可能なグラフを作成するための JavaScript ライブラリ。

インストール:

1. リポジトリのクローンを作成します。

   git clone https://github.com/muhammad-fiaz/EMSUGI.git
   cd EMSUGI

2. 依存関係をインストールします。

   pip install -r requirements.txt

3. Flask Web UI を実行します。

   python launch.py

4. ブラウザを開いて、次の場所に移動します。

    http://127.0.0.1:5000/
   

Docker で実行する

Docker を使用してこのプロジェクトを実行する場合は、docker_readme.md ファイルで、Docker コンテナーでの EMSUGI アプリケーションの構築、実行、管理に関するステップバイステップのガイドを確認してください。

フォルダー構造:

 .
├── launch.py                  # Launch Flask application
├── modules/                # Application modules
│   ├── api/                # API endpoints
│   │   ├── __init__.py    # Initialize API endpoints
│   │   ├── loading.py      # Loading API endpoint
│   │   ├── cancel_process.py      # Cancel the report generation process
│   │   .
│   │   .
│   ├── fetch_alerts.py     # Fetch report from online
│   ├── generate.py  # Generate report
│   ├── process.py  # Process the report
│   ├── router.py  # Router for the application
│   ├── db.py # Database connection
│   ├── download.py # Download the models
│   ├── async_worker.py # Async worker for the application
│   ├── routes/            # Application routes
│   │   ├── __init__.py    # Initialize application routes
│   │   ├── index_page.py      # Index Page route
│   │   ├── report_page.py      # Report Page route
│   │   ├── analytics_page.py      # Analytics Page route
│   │   ├── notice_page.py      # Notice Page route
│   │   ├── license_page.py      # License Page route
│   │   ├── records_page.py      # Records Page route
│   │   ├── reports_page.py      # Reports Page route
│   ├── utils/              # Utility functions
│   │   ├── __init__.py    # Initialize utility functions
│   │   └── progress.py     # Progress utility functions
│   │   └── check_for_cancel.py # Check if the report generation has been canceled
│   │   .
│   │   .
├── templates/              # Contains HTML templates
│   └── index.html          # Main HTML file
├── static/                 # Static files (CSS, JS, images)
│   ├── styles.css          # Global styles
├── create_database.py      # Used to create DB
├─��� database_alerts.db      # Stored Database
├── Dockerfile              # Docker configuration file
├── CODE_OF_CONDUCT.md      # Code of conduct for contributors
├── LICENSE                 # Open-source license for the project
├── pyproject.toml          # Python project configuration file
├── docker_readme.md        # Instructions for using Docker
└── README.md               # Project documentation 

使用法

• ブラウザでアプリケーションを開きます。
• 日付と時刻の範囲を入力してレポートを生成します。
• 結果をさまざまなグラフィック形式で視覚化します。

貢献する

寄付を歓迎します!プロジェクトを改善するために、遠慮なく問題を送信したり、リクエストをプルしたりしてください。貢献する際は、すべての貢献者に対して敬意を持って協力的な環境を維持するために、当社の行動規範に従ってください。

MITライセンス

 Copyright (c) 2024 Muhammad Fiaz

Permission is granted, free of charge, to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, subject to the condition that the copyright notice and this permission notice are included in all copies.

The software is provided "as is", without warranty of any kind, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, and noninfringement. In no event shall the authors be liable for any claims or damages.

詳細については、ライセンス全文を参照してください。