Metadata-Version: 2.3
Name: alithia
Version: 0.1.0
Summary: Your ultimate research companion
License: AGPL-3.0
Keywords: research,agent,paper
Author: xmingc
Author-email: chenxm35@gmail.com
Maintainer: xmingc
Maintainer-email: chenxm35@gmail.com
Requires-Python: >=3.11,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
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 :: Scientific/Engineering :: Information Analysis
Requires-Dist: arxiv (>=2.1.3,<3.0.0)
Requires-Dist: cogents (>=0.0.3,<0.0.4)
Requires-Dist: feedparser (>=6.0.11,<7.0.0)
Requires-Dist: gitignore-parser (>=0.1.11,<0.2.0)
Requires-Dist: langgraph (>=0.5.4,<0.6.0)
Requires-Dist: loguru (>=0.7.2,<0.8.0)
Requires-Dist: openai (>=1.57.0,<2.0.0)
Requires-Dist: pinecone-client (>=3.2.2,<4.0.0)
Requires-Dist: pydantic (>=2.0.0,<3.0.0)
Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
Requires-Dist: pyzotero (>=1.5.25,<2.0.0)
Requires-Dist: scikit-learn (>=1.5.2,<2.0.0)
Requires-Dist: sentence-transformers (>=3.3.1,<4.0.0)
Requires-Dist: supabase (>=2.6.0,<3.0.0)
Requires-Dist: tiktoken (>=0.8.0,<0.9.0)
Project-URL: Bug Tracker, https://github.com/caesar0301/alithia-researcher/issues
Project-URL: Documentation, https://alithia-researcher.readthedocs.io/
Project-URL: Homepage, https://github.com/caesar0301/alithia-researcher
Project-URL: Repository, https://github.com/caesar0301/alithia-researcher
Description-Content-Type: text/markdown

# Alithia Researcher

A personal academic research agent that automatically discovers, analyzes, and recommends relevant papers from ArXiv based on your Zotero library and research interests.

## Features

- **Automated Paper Discovery**: Scans ArXiv for new papers in your research areas
- **Intelligent Filtering**: Uses your Zotero library to learn your preferences
- **Smart Summaries**: Generates TLDR summaries and extracts key information
- **Email Delivery**: Sends personalized paper recommendations via email
- **GitHub Actions Integration**: Automated daily runs with configurable schedules

## Quick Start

### AlithiaArxrec Agent

See [ALITHIA_ARXREC_AGENT.md](ALITHIA_ARXREC_AGENT.md)

### AlithiaLens Agent (oncoming)

See [ALITHIA_LENS_AGENT.md](ALITHIA_LENS_AGENT.md)

### AlithiaVigil Agent (oncoming)

See [ALITHIA_VIGIL_AGENT.md](ALITHIA_VIGIL_AGENT.md)

## Development

### Running Tests
```bash
# All tests
make test

# Unit tests only
make test-unit

# Integration tests only
make test-integration
```

## Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

## License

AGPL-3.0

## Thanks

The original agentic version is from [zotero-arxiv-daily](https://github.com/TideDra/zotero-arxiv-daily). Thanks [@TideDra](https://github.com/TideDra).

