{"id":15616716,"url":"https://github.com/fanzeyi/lares","last_synced_at":"2025-07-02T06:35:54.201Z","repository":{"id":38345739,"uuid":"285483715","full_name":"fanzeyi/lares","owner":"fanzeyi","description":"Minimal Fever API (RSS Reader) Implementation","archived":false,"fork":false,"pushed_at":"2023-03-20T05:45:35.000Z","size":337,"stargazers_count":30,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-16T18:56:03.909Z","etag":null,"topics":["fever","fever-api","rss","rss-aggregator"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/fanzeyi.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}},"created_at":"2020-08-06T05:39:33.000Z","updated_at":"2025-06-13T14:56:58.000Z","dependencies_parsed_at":"2024-10-22T02:13:57.120Z","dependency_job_id":null,"html_url":"https://github.com/fanzeyi/lares","commit_stats":{"total_commits":41,"total_committers":4,"mean_commits":10.25,"dds":0.2682926829268293,"last_synced_commit":"0658fb25865df168fdf3b8ddc3d1686f146c8639"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/fanzeyi/lares","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fanzeyi%2Flares","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fanzeyi%2Flares/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fanzeyi%2Flares/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fanzeyi%2Flares/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fanzeyi","download_url":"https://codeload.github.com/fanzeyi/lares/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fanzeyi%2Flares/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260221335,"owners_count":22976861,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["fever","fever-api","rss","rss-aggregator"],"created_at":"2024-10-03T07:21:23.386Z","updated_at":"2025-07-02T06:35:54.168Z","avatar_url":"https://github.com/fanzeyi.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lares: Minimal Fever API Implementation\n\n[![Build Status](https://github.com/fanzeyi/lares/workflows/Build%20\u0026%20Test/badge.svg)](https://github.com/fanzeyi/lares/actions?query=workflow%3A%22Build+%26+Test%22)\n[![Crates.io](https://img.shields.io/crates/v/lares)](https://crates.io/crates/lares)\n[![Docker Status](https://img.shields.io/docker/cloud/build/fanzeyi/lares.svg)](https://hub.docker.com/r/fanzeyi/lares)\n\n**Lares** is a minimal [Fever API](https://feedafever.com/api) implementation\nwritten in Rust. It aims to provide a RSS reader backend with zero setup. It\nuses SQLite 3 as storage engine. **It does not provide an user interface.**\n\nIt is recommended to use Reeder as client to lares.\n\n## Install\n\n**Cargo**\n\n```\ncargo install lares\n```\n\n**Docker**\n\n```\ndocker run -it fanzeyi/lares\n```\n\n**Pre-built Binary**\n\nFor each release, GitHub Action will attach pre-built binaries for Ubuntu,\nmacOS and Windows. You can find these binaries in the [release\npage](https://github.com/fanzeyi/lares/releases).\n\n## Usage\n\nLares consists of two parts, CLI and server. Feeds and groups are only\nmanageable via the command line interface.\n\n```\n$ lares --help\nlares 0.2.1\nMinimal RSS service\n\nUSAGE:\n    lares [FLAGS] [OPTIONS] \u003cSUBCOMMAND\u003e\n\nFLAGS:\n        --debug\n    -h, --help       Prints help information\n    -V, --version    Prints version information\n\nOPTIONS:\n    -d, --database \u003cdatabase\u003e     [env: LARES_DATABASE=]  [default: lares.db]\n\nSUBCOMMANDS:\n    feed      Manages feeds\n    group     Manages group\n    help      Prints this message or the help of the given subcommand(s)\n    server    Starts web server\n```\n\nOr, to start a server:\n\n```\n$ lares server --help\nlares-server 0.2.1\nStarts web server\n\nUSAGE:\n    lares server [OPTIONS]\n\nFLAGS:\n    -h, --help       Prints help information\n    -V, --version    Prints version information\n\nOPTIONS:\n    -H, --host \u003chost\u003e            Specifies server host [env: LARES_HOST=]  [default: 127.0.0.1]\n    -i, --interval \u003cinterval\u003e    Specifies crawl interval (unit: minutes) [env: LARES_INTERVAL=]  [default: 30]\n    -P, --password \u003cpassword\u003e    Specifies authentication password [env: LARES_PASSWORD=]\n    -p, --port \u003cport\u003e            Specifies alternate port [env: LARES_PORT=]  [default: 4000]\n    -u, --username \u003cusername\u003e    Specifies authentication username [env: LARES_USERNAME=]\n```\n\nTo start a lares server listens to `127.0.0.1:4000` that only accepts\nauthentication with `lares` and `apassword` and placing the SQLite database\nat `/var/lares.db`, run:\n\n```\n$ lares --database /var/lares.db server --host 127.0.0.1 --port 4000 \\\n  --username lares --password apassword\n```\n\n## Docker Compose\n\nIf you'd like to start a Lares host with Docker Compose, you may start with\nthis configuration:\n\n```yaml\nversion: '3'\nservices:\n  lares:\n    image: fanzeyi/lares:latest\n    ports:\n      - \"127.0.0.1:4000:4000\"\n    restart: always\n    # Uncomment this to persist the storage on the host.\n    # volumes:\n    #  - ./run/lares:/var/lares\n    environment:\n      LARES_DATABASE: /var/lares/lares.db\n      LARES_HOST: 0.0.0.0\n      LARES_USERNAME: username\n      LARES_PASSWORD: password\n```\n\nThen you can use `docker-compose exec lares lares` to access Lares's command\nline interface inside the container. For example, if you want to add a feed,\nuse:\n\n```\ndocker-compose exec lares lares feed add http://example.com/\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffanzeyi%2Flares","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffanzeyi%2Flares","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffanzeyi%2Flares/lists"}