Metadata-Version: 2.4
Name: comike-cli
Version: 0.107.1
Summary: CLI tool for Comiket WebCatalog with natural language interface
Project-URL: Homepage, https://github.com/m96-chan/comike-cli
Project-URL: Repository, https://github.com/m96-chan/comike-cli
Project-URL: Issues, https://github.com/m96-chan/comike-cli/issues
Author: m96-chan
License-Expression: MIT
License-File: LICENSE
Keywords: catalog,circle.ms,cli,comiket,doujin
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: openai>=1.0.0
Requires-Dist: pillow>=10.0.0
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# comike-cli

A Python CLI tool for browsing Comiket WebCatalog with a Claude Code-like interactive interface.

## Overview

Search and browse Comiket circle information from your terminal using the Circle.ms [WebCatalog API](https://docs.circle.ms/webcatalog/ctn/developer/001.html).

## Features

### Circle Search & Browse
- Search by circle name
- Filter by genre and hall
- View circle details
- Display circle cut images (Braille Unicode art)

### Work Search
- Keyword search by work name/description
- Filter by new/existing releases
- View work details

### Favorites Management
- Add/remove/update favorite circles
- Organize with color labels (9 colors)
- Add memos
- View favorites list

### Event Information
- Get event list
- Access past event data

## Requirements

- Python 3.10+
- Circle.ms developer account (required for API access)

### Mobile

Rust is required to build the `jiter` dependency (used by `openai` package).

**Termux (Android)**
```bash
pkg install python rust ndk-sysroot clang make libjpeg-turbo
```

**iSH (iOS)**
```bash
apk add python3 py3-pip rust cargo gcc musl-dev jpeg-dev zlib-dev
```
Note: iSH uses x86 emulation, so compilation may be slow or unstable.

## Installation

```bash
pip install comike-cli
```

Or install from source:

```bash
git clone https://github.com/m96-chan/comike-cli.git
cd comike-cli
pip install -e .
```

## Setup

1. Register as a developer at [Circle.ms](https://docs.circle.ms/webcatalog/ctn/developer/001.html) to obtain Client ID and Client Secret
2. Create `~/.comike_cli/.env` with your credentials

```bash
mkdir -p ~/.comike_cli
cat > ~/.comike_cli/.env << 'EOF'
CIRCLE_MS_CLIENT_ID=your_client_id
CIRCLE_MS_CLIENT_SECRET=your_client_secret
OPENAI_API_KEY=your_openai_api_key
EOF
```

## Usage

```bash
# Start interactive mode
comike

# Example queries (in natural language)
# "Search for circles with 東方"
# "Show my favorites"
# "Add this circle to favorites"

# Commands
# /help  - Show help
# /clear - Clear conversation history
# /quit  - Exit
```

## Development

```bash
# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check .
```

## License

MIT

## Important Notes

- Data obtained via the API must not be redistributed or used for purposes other than app development
- Bulk export functionality for circle information is prohibited
- Web application development is not permitted
- API specification redistribution/publication is prohibited

See the [Developer Guidelines](https://docs.circle.ms/webcatalog/ctn/developer/003.html) for details.
