Metadata-Version: 2.3
Name: alithia
Version: 0.1.4
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,<3.14
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_core (>=0.1.13,<0.2.0)
Requires-Dist: feedparser (>=6.0.11,<7.0.0)
Requires-Dist: gitignore-parser (>=0.1.11,<0.2.0)
Requires-Dist: loguru (>=0.7.2,<0.8.0)
Requires-Dist: pinecone-client (>=3.2.2,<4.0.0)
Requires-Dist: pydantic (>=2.0.0,<3.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: Documentation, https://alithia.readthedocs.io/
Project-URL: Homepage, https://github.com/caesar0301/alithia
Project-URL: Repository, https://github.com/caesar0301/alithia
Description-Content-Type: text/markdown

# Alithia

[![PyPI version](https://img.shields.io/pypi/v/alithia.svg)](https://pypi.org/project/alithia/)


Time is one of the most valuable resources for a human researcher, best spent
on thinking, exploring, and creating in the world of ideas. With Alithia, we
aim to open a new frontier in research assistance. Alithia aspires to be your
powerful research companion: from reading papers to pursuing interest-driven
deep investigations, from reproducing experiments to detecting fabricated
results, from tracking down relevant papers to monitoring industrial
breakthroughs. At its core, Alithia forges a strong and instant link between your personal
research profile, the latest state-of-the-art developments, and pervasive cloud
resources, ensuring you stay informed, empowered, and ahead.

## Features

In Alithia, we connect each researcher’s profile with publicly available academic resources, leveraging widely accessible cloud infrastructure to automate the entire process. In its current version, Alithia is designed to support the following features:

* Reseacher Profile
  * Basic profile: research interests, expertise, language
  * Connected (personal) services:
    * LLM (OpenAI compatible)
    * Zotero library
    * Email notification
    * Github profile
    * Google scholar profile
    * X account message stream
  * Gems (general research digest or ideas)
* Academic Resources
  * arXiv papers
  * Google scholar search
  * Web search engines (e.g., tavily)
  * Individual researcher homepage

## Quick Start

### Alithia Arxrec Agent

An paper recommendation agent, by connection researcher profile and arXiv paper updates. The original version of arxrec agent is based on [zotero-arxiv-daily](https://github.com/TideDra/zotero-arxiv-daily). Thanks for [@TideDra](https://github.com/TideDra).

See [ALITHIA_ARXREC_AGENT.md](docs/guide/ALITHIA_ARXREC_AGENT.md)

### Alithia Lens Agent (oncoming)

See [ALITHIA_LENS_AGENT.md](docs/guide/ALITHIA_LENS_AGENT.md)

### Alithia Vigil Agent (oncoming)

See [ALITHIA_VIGIL_AGENT.md](docs/guide/ALITHIA_VIGIL_AGENT.md)

## License

AGPL-3.0

## Contributing

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

