{"id":35572878,"url":"https://github.com/caesar0301/alithia","last_synced_at":"2026-01-24T18:47:50.738Z","repository":{"id":332408930,"uuid":"1080905184","full_name":"caesar0301/alithia","owner":"caesar0301","description":"Your ultimate research companion","archived":false,"fork":false,"pushed_at":"2026-01-07T06:40:01.000Z","size":305,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-13T19:44:47.871Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/caesar0301.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-10-22T03:10:41.000Z","updated_at":"2026-01-07T06:40:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/caesar0301/alithia","commit_stats":null,"previous_names":["caesar0301/alithia"],"tags_count":2,"template":false,"template_full_name":"mirasoth/pytemplate","purl":"pkg:github/caesar0301/alithia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caesar0301%2Falithia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caesar0301%2Falithia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caesar0301%2Falithia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caesar0301%2Falithia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caesar0301","download_url":"https://codeload.github.com/caesar0301/alithia/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caesar0301%2Falithia/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28734316,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T17:51:25.893Z","status":"ssl_error","status_checked_at":"2026-01-24T17:50:48.377Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-04T18:16:54.749Z","updated_at":"2026-01-24T18:47:50.731Z","avatar_url":"https://github.com/caesar0301.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Alithia\n\n[![PyPI version](https://img.shields.io/pypi/v/alithia.svg)](https://pypi.org/project/alithia/)\n\n\nTime is one of the most valuable resources for a human researcher, best spent\non thinking, exploring, and creating in the world of ideas. With Alithia, we\naim to open a new frontier in research assistance. Alithia aspires to be your\npowerful research companion: from reading papers to pursuing interest-driven\ndeep investigations, from reproducing experiments to detecting fabricated\nresults, from tracking down relevant papers to monitoring industrial\nbreakthroughs. At its core, Alithia forges a strong and instant link between your personal\nresearch profile, the latest state-of-the-art developments, and pervasive cloud\nresources, ensuring you stay informed, empowered, and ahead.\n\n## Features\n\nIn 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:\n\n* Reseacher Profile\n  * Basic profile: research interests, expertise, language\n  * Connected (personal) services:\n    * LLM (OpenAI compatible)\n    * Zotero library\n    * Email notification\n    * Github profile\n    * Google scholar profile\n    * X account message stream\n  * Gems (general research digest or ideas)\n* Academic Resources\n  * arXiv papers\n  * Google scholar search\n  * Web search engines (e.g., tavily)\n  * Individual researcher homepage\n\n## Installation\n\nAlithia uses optional dependencies to keep the base installation lightweight. The default installation includes PaperScout agent dependencies.\n\n### Recommended: Default Installation\n\nFor most users, install with default dependencies (includes PaperScout agent: ArXiv fetching, Zotero integration, email notifications, etc.):\n\n```bash\npip install alithia[default]\n```\n\nThis installs:\n- `arxiv` - ArXiv paper fetching\n- `pyzotero` - Zotero library integration\n- `scikit-learn` - Machine learning utilities\n- `sentence-transformers` - Embedding models\n- `feedparser` - RSS feed parsing\n- `beautifulsoup4` \u0026 `lxml` - Web scraping\n- `tiktoken` - Token counting\n- And other PaperScout dependencies\n\n**Note:** `alithia[paperscout]` is an alias for `alithia[default]` and works the same way.\n\n### Minimal Installation\n\nInstall only the core library (includes `cogents-core` only, no PaperScout features):\n\n```bash\npip install alithia\n```\n\n⚠️ **Warning:** This minimal installation does not include PaperScout agent dependencies. Most users should use `alithia[default]` instead.\n\n### Install with PaperLens Support\n\nFor PDF analysis and deep paper interaction:\n\n```bash\npip install alithia[paperlens]\n```\n\nThis installs:\n- `docling` - PDF parsing and OCR\n- `onnxruntime` - Model inference\n\n### Install All Features\n\nInstall everything (Default/PaperScout + PaperLens):\n\n```bash\npip install alithia[all]\n```\n\n### Development Installation\n\nFor development, clone the repository and install with development dependencies:\n\n```bash\ngit clone https://github.com/caesar0301/alithia.git\ncd alithia\nuv sync --extra default --extra dev\n```\n\nOr using pip:\n\n```bash\npip install -e \".[default,dev]\"\n```\n\n**Note:** You can also use `alithia[paperscout,dev]` as `paperscout` is an alias for `default`.\n\n## Quick Start\n\n### 1. Setup PaperScout Agent\n\nThe PaperScout Agent delivers daily paper recommendations from arXiv to your inbox.\n\n**Prerequisites:**\n1. **Zotero Account**: [Sign up](https://www.zotero.org) and get your user ID and API key from Settings → Feeds/API\n2. **OpenAI API Key**: From any OpenAI-compatible LLM provider\n3. **Email (Gmail)**: Enable 2FA and generate an App Password\n\n**GitHub Actions Setup:**\n1. Fork this repository\n2. Go to Settings → Secrets and variables → Actions\n3. Add secret `ALITHIA_CONFIG_JSON` with your configuration (see below)\n4. Agent runs automatically daily at 01:00 UTC\n\n### 2. Configuration\n\nCreate a JSON configuration with your credentials. See [alithia_config_example.json](alithia_config_example.json) for a complete example.\n\n## Storage Backend\n\nAlithia uses **Supabase** (PostgreSQL) as the default stateful storage backend, with automatic fallback to **SQLite** when Supabase is unavailable. This enables:\n\n- **Persistent caching** of Zotero libraries and parsed papers\n- **Continuous paper feeding** that handles ArXiv indexing delays\n- **Deduplication** to prevent duplicate email notifications  \n- **Query history** tracking for PaperLens interactions\n\n### Quick Setup\n\n1. **Create a Supabase project** at [supabase.com](https://supabase.com) (free tier available)\n2. **Run the migration**: Copy contents of `alithia/storage/migrations/001_initial_schema.sql` to Supabase SQL Editor\n3. **Configure Alithia**: Add Supabase credentials to your config:\n\n```json\n{\n  \"storage\": {\n    \"backend\": \"supabase\",\n    \"fallback_to_sqlite\": true,\n    \"user_id\": \"your_email@example.com\"\n  },\n  \"supabase\": {\n    \"url\": \"https://xxxxx.supabase.co\",\n    \"anon_key\": \"your_anon_key\",\n    \"service_role_key\": \"your_service_role_key\"\n  }\n}\n```\n\n### Storage Options\n\n- **Supabase (default)**: Cloud PostgreSQL with automatic backups, full-text search, and multi-user support\n- **SQLite (fallback)**: Local single-file database, works offline, no setup required\n\nFor detailed setup instructions, see [docs/SUPABASE_SETUP.md](docs/SUPABASE_SETUP.md).\n\n## License\n\nMIT\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests\n5. Submit a pull request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaesar0301%2Falithia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaesar0301%2Falithia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaesar0301%2Falithia/lists"}