{"id":50787090,"url":"https://github.com/teppyboy/ayayaxyz","last_synced_at":"2026-06-12T08:33:09.466Z","repository":{"id":65297473,"uuid":"531998634","full_name":"teppyboy/ayayaxyz","owner":"teppyboy","description":"A bot for Telegram","archived":false,"fork":false,"pushed_at":"2023-06-03T08:04:21.000Z","size":613,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-06-03T09:20:57.402Z","etag":null,"topics":["bot","pixiv","python","telegram"],"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/teppyboy.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}},"created_at":"2022-09-02T16:21:44.000Z","updated_at":"2022-11-07T12:53:54.000Z","dependencies_parsed_at":"2023-02-10T09:45:46.616Z","dependency_job_id":null,"html_url":"https://github.com/teppyboy/ayayaxyz","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/teppyboy/ayayaxyz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teppyboy%2Fayayaxyz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teppyboy%2Fayayaxyz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teppyboy%2Fayayaxyz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teppyboy%2Fayayaxyz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teppyboy","download_url":"https://codeload.github.com/teppyboy/ayayaxyz/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teppyboy%2Fayayaxyz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34236551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["bot","pixiv","python","telegram"],"created_at":"2026-06-12T08:33:07.645Z","updated_at":"2026-06-12T08:33:09.457Z","avatar_url":"https://github.com/teppyboy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AyayaXYZ\n\nA bot for Telegram that currently can interact with Pixiv\n\n## Getting started\n\nTo run this bot, you need to have these environment variables (or put them in .env):\n\n```bash\nTOKEN=\u003cTelegram bot token\u003e\nWEB_URL=\u003cwebsite url for API features\u003e\nPIXIV_REFRESH_TOKEN=\u003crefresh-token\u003e\n# if PIXIV_REFRESH_TOKEN doesn't exist, it'll read username \u0026 password from env vars below\nPIXIV_USERNAME=\u003cusername\u003e\nPIXIV_PASSWORD=\u003cpassword\u003e\n# If you want to change log level (default is INFO)\nLOGLEVEL=DEBUG\n```\n\nThen use poetry to install project dependencies:\n\n```bash\npoetry install\n# or poetry install -E login for logging in with credential support (Chrome required)\n```\n\nAnd finally run the bot itself:\n\n```bash\npoetry run python -m ayayaxyz\n```\n\n## Commands\n\nCurrently there is 1 command available:\n\n### `pixiv`\n\n#### `search`\n\nSearch an image from the given keywords, which is seperated by \",\".\n\n+ `-P`/`--popular`: Search only popular-related images.\n+ `--no-related`: Do not search for related image in the search algorithm *(more duplicated images!)*\n+ `--no-tl`/`--no-translate-tags`: Do not translate tags from English to Japanese (e.g: Nino Nakano won't be translated to 中野二乃 before searching)\n+ `-\u003ctag\u003e` to exclude `\u003ctag\u003e` from search result (can be specified multiple times)\n\n\u003e E.g: `/pixiv search Ayaka, Ayato, -P, --no-related, -Keqing`: This will search for image with \"Ayaka\", \"Ayato\" *without* searching for related image and \"Keqing\" tag.\n\n#### `qsearch`\n\nA quick variant of `search`, provides result faster but worse resolution.\n\n#### `id`\n\nFetch image(s) from the given ID/url, and optionally only fetch specified pages (seperated by \" \")\n\u003e E.g: `/pixiv id https://www.pixiv.net/en/artworks/99945929` or `/pixiv id 99945929`\n\n#### `qid`\n\nA quick variant of `id`, provides result faster but worse resolution.\n\n#### `fid`\n\nAn experimental variant of `id` which uses AyayaXYZ internal server to post Telegram images instead of uploading it directly.\n\nBy doing this it'll achieve faster upload speed (even faster than `qid`) and provides nearly-good image (same as `id`) (original image is not possible since Telegram compresses images by bot) but a major drawback is if the webserver dies, this function will stop working.\n\n\u003e This can be workaround by using a reliable reverse proxy like [pixiv.re](https://pixiv.re)\n\n#### `related`\n\nSearch a related image from the given ID/url, and optionally specify tags (following `search` rules) to check the related image against, which will improve the image search result.\n\n\u003e E.g: `/pixiv related https://www.pixiv.net/en/artworks/99945929 Eula, -Keqing` or `/pixiv related 99945929`\n\n#### `qrelated`\n\nA quick variant of `related`, provides result faster but worse resolution.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteppyboy%2Fayayaxyz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteppyboy%2Fayayaxyz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteppyboy%2Fayayaxyz/lists"}