Metadata-Version: 2.4
Name: pymirage
Version: 0.1.1.dev2
Summary: 高性能日本語形態素解析ライブラリ - SudachiPyとGemini AIによるテキスト分析
Project-URL: Homepage, https://github.com/yourusername/mirage-core
Project-URL: Documentation, https://github.com/yourusername/mirage-core#readme
Project-URL: Repository, https://github.com/yourusername/mirage-core
Project-URL: Issues, https://github.com/yourusername/mirage-core/issues
Author: Mirage Contributors
License-Expression: GPL-3.0-only
License-File: LICENSE
Keywords: ai,gemini,japanese,morphological-analysis,nlp,sudachi,text-analysis
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.12
Requires-Dist: google-generativeai>=0.3.2
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: sudachidict-full>=20240109
Requires-Dist: sudachipy>=0.6.8
Provides-Extra: dev
Requires-Dist: mypy>=1.7.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# Mirage-Core

日本語文章解析エンジン。伝統的な自然言語処理（NLP）とLLMを組み合わせたハイブリッドアーキテクチャを採用しています。

## 🚀 クイックスタート

### Docker Hub から実行（最も簡単）

```bash
# Docker Hub から最新イメージを取得
docker pull stayforge/mirage:latest

# コンテナを起動
docker run -d -p 8000:8000 stayforge/mirage:latest

# API にアクセス
curl http://localhost:8000/analysis/health
```

### Docker Compose で実行

```bash
# リポジトリをクローン
git clone https://github.com/[your-repo]/Mirage-Core.git
cd Mirage-Core

# Docker Compose で起動
docker-compose up -d

# API にアクセス
curl http://localhost:8000/analysis/health
```

詳細は [DOCKER.md](./DOCKER.md) を参照

### ローカル環境で実行

```bash
# 依存関係をインストール
pip install -r requirements.txt

# UniDic 辞書をダウンロード（初回のみ）
python -m unidic download

# API サーバーを起動
python main.py
```

## 📚 API ドキュメント

起動後、以下の URL でアクセス：

- **Swagger UI**: http://localhost:8000/docs
- **ReDoc**: http://localhost:8000/redoc
- **API ガイド**: [API.md](./API.md)

## 🧪 テスト

```bash
# 全テストを実行
pytest tests/ -v

# API テストのみ
pytest tests/test_api.py -v

# 分析機能テストのみ
pytest tests/test_analysis.py -v
```

## 🔄 CI/CD

GitHub Actions による自動ビルド・デプロイを設定済み

- **main ブランチ**: `stayforge/mirage:latest`
- **dev ブランチ**: `stayforge/mirage:dev`
- **バージョンタグ**: `stayforge/mirage:v1.0.0`

セットアップ方法: [CI_SETUP.md](./CI_SETUP.md)

## 🛠️ Tools

A tool to convert other formats (mainly Aozora Bunko) to .MDI

Supported file(text) formats:
- Plain text (.txt)
- Markdown (.md)
- [HTML](./samples/蜃気楼/芥川龍之介-蜃気楼.html)（青空文庫）
- [illusion Markdown](https://github.com/Iktahana/illusions/blob/main/MDI.md) (.imd)

