Metadata-Version: 2.4
Name: elizaos-plugin-instagram
Version: 2.0.0a5
Summary: Instagram plugin for elizaOS - Python implementation for Instagram integration
Project-URL: Homepage, https://github.com/elizaos/eliza
Project-URL: Documentation, https://elizaos.ai/docs
Project-URL: Repository, https://github.com/elizaos/eliza
Author: elizaOS Contributors
License-Expression: MIT
Keywords: agents,ai,elizaos,instagram,social
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: httpx>=0.28.0
Requires-Dist: instagrapi>=2.0.0
Requires-Dist: pydantic>=2.10.0
Provides-Extra: dev
Requires-Dist: mypy>=1.14.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
Requires-Dist: pytest-xprocess>=1.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: python-dotenv>=1.0.0; extra == 'dev'
Requires-Dist: ruff>=0.8.0; extra == 'dev'
Description-Content-Type: text/markdown

# elizaOS Instagram Plugin (Python)

Instagram integration for elizaOS agents.

## Features

- Instagram direct message handling
- Post and story interactions
- Comment management
- Media upload support
- User profile interactions

## Installation

```bash
pip install elizaos-plugin-instagram
```

## Configuration

The plugin requires the following environment variables:

- `INSTAGRAM_USERNAME` (required): Your Instagram username
- `INSTAGRAM_PASSWORD` (required): Your Instagram password
- `INSTAGRAM_VERIFICATION_CODE` (optional): 2FA verification code if enabled

## Usage

```python
from elizaos_plugin_instagram import InstagramService, InstagramConfig

# Create configuration
config = InstagramConfig.from_env()

# Initialize service
service = InstagramService(config)

# Start the service
await service.start()
```

## Event Types

The plugin emits the following event types:

- `INSTAGRAM_MESSAGE_RECEIVED` - Direct message received
- `INSTAGRAM_MESSAGE_SENT` - Direct message sent
- `INSTAGRAM_COMMENT_RECEIVED` - Comment on post received
- `INSTAGRAM_LIKE_RECEIVED` - Like on post received
- `INSTAGRAM_FOLLOW_RECEIVED` - New follower

## Development

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

# Run tests
pytest

# Type checking
mypy elizaos_plugin_instagram

# Linting
ruff check elizaos_plugin_instagram
ruff format elizaos_plugin_instagram
```

## License

MIT
