Metadata-Version: 2.3
Name: colino
Version: 0.1.0
Summary: Your personal news digest (macOS only)
Author: Umberto D'Ovidio
Author-email: umbertod@fastmail.com
Requires-Python: >=3.11,<3.14
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: MacOS
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 :: Utilities
Requires-Dist: feedparser (>=6.0.11,<7.0.0)
Requires-Dist: google-api-python-client (>=2.179.0,<3.0.0)
Requires-Dist: google-auth (>=2.40.3,<3.0.0)
Requires-Dist: google-auth-httplib2 (>=0.2.0,<0.3.0)
Requires-Dist: google-auth-oauthlib (>=1.2.2,<2.0.0)
Requires-Dist: jinja2 (>=3.1.6,<4.0.0)
Requires-Dist: openai (>=1.102.0,<2.0.0)
Requires-Dist: pyyaml (>=6.0.2,<7.0.0)
Requires-Dist: requests (>=2.32.5,<3.0.0)
Requires-Dist: trafilatura (>=2.0.0,<3.0.0)
Requires-Dist: youtube-transcript-api (>=1.2.2,<2.0.0)
Description-Content-Type: text/markdown

# Colino 📰

Your own hackable aggregator and AI-powered digest generator. https://colino.pages.dev

## What is Colino?

Colino is a simple, powerful, and completely free feed aggregator that lets you create your own personalized news digest from any RSS-enabled website. Additionally, Colino leverages LLM to generate a digest of the latest news
Currently, it supports the following sources:
- RSS feed
- Your youtube subscriptions


## Platform Support
**Colino currently only runs on macOS.**
Linux and Windows support is planned for the future.

## Status
Colino is in active development and APIs and commands are expected to change before the official release.

## Setup project

The project uses pyenv and poetry to manage python version and dependencies

1. **Use correct python version**
   ```bash
   pyenv local
   ```

2. **Install dependencies:**
   ```bash
   poetry install
   ```

3. **Digest content using AI:**
By default the digest command will use the last 24 hours of content from all configured sources.
   ```bash
   poetry run colino digest
   ```
You can also pass a single url to digest a specific article or video:
   ```bash
   poetry run colino digest <a url>
   ```
Or you can choose to digest only content from a specific source:
   ```bash
   poetry run colino digest --youtube
   ```

## Install colino as command line tool

```bash
poetry build
pipx install dist/colino-*.whl

```

### Feedback and contribution

Create a new issue for any feedback, requests and contribution ideas. We can take it from there

