EMSUGI

엠스기

목차

• 프로젝트 개요
• 주요 특징
• 스크린샷
• 시작하기
  • 기술 스택
  • 설치
  • 도커로 실행하기
  • 폴더 구조
• 용법
• 기여
• MIT 라이센스

프로젝트 개요

EMSUGI 는 다양한 소스로부터 긴급 경보를 수집하고 분석하도록 설계된 정교한 애플리케이션입니다. 생성적 AI를 활용하여 과거 데이터와 현재 추세를 기반으로 향후 사고를 예측합니다. 이 시스템은 통찰력 있는 보고서와 시각적 분석을 제공하여 비상 대응의 효율성을 높이는 것을 목표로 합니다.

이 프로젝트가 마음에 든다면 이 저장소에 별표를 표시하고 기여하고 싶다면 포크하는 것을 잊지 마세요 ! 귀하의 기여와 지원에 크게 감사드립니다!

주요 특징:

• 실시간 경보 모니터링 : 여러 국가의 긴급 경보를 가져오고 저장합니다.
• Generative AI : AI를 구현하여 긴급 상황에 대한 미래 예측을 분석하고 생성합니다.
• 그래픽 표현 : 차트와 그래프를 사용하여 데이터를 표시하므로 사용자가 주요 지표를 시각화할 수 있습니다.
• 대화형 날짜/시간 범위 선택 : 사용자가 보고서 생성을 위한 사용자 정의 날짜 및 시간 범위를 설정할 수 있습니다.
• 키워드 및 주제 분석 : 국가별, 지역별 인기 키워드 및 주제를 파악합니다.
• 반응형 디자인 : 보고서 보기를 위한 모바일 친화적인 반응형 레이아웃을 지원합니다.

참고: 이러한 기능은 프로젝트의 향후 의도를 기반으로 하기 때문에 실제 성능과 기능은 진행 중인 개발 단계에 따라 달라질 수 있습니다.

스크린샷

다음은 시스템의 기능과 레이아웃을 보여주는 일부 스크린샷입니다.

참고: 이 스크린샷은 프로젝트 개발의 현재 상태를 반영하며 향후 기능이 발전하고 개선됨에 따라 변경될 수 있습니다.

시작하기

기술 스택:

• Python (버전 3.x 이상): 백엔드 개발에 사용되는 강력한 고급 프로그래밍 언어입니다.
• Flask : Python으로 웹 애플리케이션을 구축하기 위한 경량 웹 프레임워크입니다.
• pandas : 데이터 분석을 위한 강력한 데이터 구조를 제공하는 데이터 조작 라이브러리입니다.
• matplotlib : 정적, 애니메이션 및 대화형 시각화를 만드는 데 사용되는 인기 있는 플로팅 라이브러리입니다.
• gemini : 비상 및 재난 보고서 작성에 사용되는 생성 보고서 생성을 위한 AI 기반 도구입니다.
• torch : 특히 로컬 모델 추론을 위해 기계 학습 모델을 훈련하고 배포하기 위한 유연하고 효율적인 도구를 제공하는 딥 러닝 프레임워크입니다.
• Transformers : 사전 훈련된 변환기 및 기타 최첨단 기계 학습 모델을 사용하기 위한 Hugging Face의 라이브러리입니다.
• logly : 애플리케이션 내에서 로그를 추적하고 관리하는 데 사용되는 로깅 및 모니터링 도구입니다.
• python-dotenv : 환경 변수를 관리하는 도구로, .env 파일에서 민감한 정보(API 키, 토큰 등)를 구성할 수 있습니다.
• SQLite : 애플리케이션의 데이터를 저장하고 검색하는 경량의 디스크 기반 데이터베이스입니다.
• Tailwind CSS : 반응성이 뛰어난 최신 웹 인터페이스를 빠르게 디자인하기 위한 유틸리티 우선 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 웹 UI를 실행합니다.

   python launch.py

4. 브라우저를 열고 다음으로 이동하세요.

    http://127.0.0.1:5000/
   

도커로 실행하기

Docker를 사용하여 이 프로젝트를 실행하려면 Docker 컨테이너에서 EMSUGI 애플리케이션을 구축, 실행 및 관리하는 방법에 대한 단계별 가이드를 docker_readme.md 파일에서 확인하세요.

폴더 구조:

 .
├── 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.

자세한 내용은 전체 라이센스를 참조하세요.