{"id":13343305,"url":"https://github.com/desobolevsky/BYCurrenciesTelegramBot","last_synced_at":"2025-03-12T04:33:09.549Z","repository":{"id":50163356,"uuid":"281731587","full_name":"desobolevsky/BYCurrenciesTelegramBot","owner":"desobolevsky","description":"Telegram bot showing actual exchange rates in Belarus - https://t.me/BY_Currencies_bot","archived":false,"fork":false,"pushed_at":"2022-12-08T11:17:06.000Z","size":15,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-10-24T15:39:08.433Z","etag":null,"topics":["beautifulsoup4","telegram-bot","yaml"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/desobolevsky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-22T16:41:20.000Z","updated_at":"2020-09-13T10:56:16.000Z","dependencies_parsed_at":"2023-01-25T12:16:04.009Z","dependency_job_id":null,"html_url":"https://github.com/desobolevsky/BYCurrenciesTelegramBot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desobolevsky%2FBYCurrenciesTelegramBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desobolevsky%2FBYCurrenciesTelegramBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desobolevsky%2FBYCurrenciesTelegramBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desobolevsky%2FBYCurrenciesTelegramBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/desobolevsky","download_url":"https://codeload.github.com/desobolevsky/BYCurrenciesTelegramBot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243158974,"owners_count":20245668,"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":["beautifulsoup4","telegram-bot","yaml"],"created_at":"2024-07-29T19:31:08.072Z","updated_at":"2025-03-12T04:33:09.308Z","avatar_url":"https://github.com/desobolevsky.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# BYCurrenciesTelegramBot\n\nBYCurrenciesTelegramBot is a telegram bot that shows exchange rates at present day in Belarus.\nTo launch the bot, follow the link - https://t.me/BY_Currencies_bot, or write to the bot directly in Telegram - @BY_Currencies_bot .\n\n\n\u003cp\u003e\u003cimg align = \"center\" src = \"https://i.ibb.co/JxYMXGw/IMG-6952.png\" width =\"250\"/\u003e \u003cimg align = \"center\" src = \"https://i.ibb.co/R3npLN3/IMG-6953.png\" width =\"250\"/\u003e \u003cimg align = \"center\" src = \"https://i.ibb.co/t81DRfK/IMG-6955.png\" width =\"250\"/\u003e\u003c/p\u003e\n\n\n# Description\nIn dialog with the bot, you can use these commands to interact with it:\n\n  - /general - for general overview of exchange rates at present day\n  - /banks - for detailed list of exchange rate for each bank\n  - /help - if you need any kind of help ;) \n\nCurrencies are parsed from [finance.tut.by](https://finance.tut.by/kurs/minsk/) and  [myfin.by](https://myfin.by/currency/minsk) websites.\n\nNote: exchange rates are updated no more than every 30 minutes (depends on bot users activity).\n\n## Tech\nBYCurrenciesTelegramBot uses a number of open source projects to work properly:\n\n* [BeautifulSoup](https://www.crummy.com/software/BeautifulSoup/) - package for parsing HTML and XML documents.\n* [pyTelegramBotAPI](https://github.com/eternnoir/pyTelegramBotAPI) - simple, but powerful Python wrapper for the [Telegram Bot API](https://core.telegram.org/bots/api).\n* [PyYAML](https://github.com/yaml/pyyaml) - YAML parser and emitter for Python.\n\n## Installation\n\nIn order to get the project for review, editing or testing, clone project:\n```sh\n$ git clone https://github.com/desobolevsky/BYCurrenciesTelegramBot.git\n```\n\nCreate a new virtual environment and install the dependencies:\n\n```sh\n$ cd BYCurrenciesTelegramBot\n$ virtualenv venv\n$ source venv/bin/activate\n$ pip install -r requirements.txt\n```\nCreate your bot in Telegram via interacting with [@BotFather](https://t.me/BotFather) and get API key for your bot (see https://core.telegram.org/bots#6-botfather for more information).\n\nRename config.yaml.dist file to config.yaml:\n```sh\n$ mv config.yaml.dist config.yaml\n```\nPaste your API key to config.yaml so the file looks as follows:\n```\napi_key: YOUR_API_KEY_HERE\n```\n\nRun the bot:\n\n```sh\n$ python3 main.py\n```\n\nYour bot started, now you can enjoy exchange rates in Belarus! :)\n\n\n## Todos\n\n - Add sorted exchange rates, so that the best ones are displayed first\n - Add statistics\n - Add daily notifications \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdesobolevsky%2FBYCurrenciesTelegramBot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdesobolevsky%2FBYCurrenciesTelegramBot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdesobolevsky%2FBYCurrenciesTelegramBot/lists"}