Skip to main content

Telegram bot based on `davtelepot` providing information about CicloPi, the public bike-sharing service in Pisa.

Project description


@CicloPiBot is a Telegram bot based on davtelepot which provides information about CicloPi, the public bike-sharing service in Pisa.


Client side

Send /start @CicloPiBot, all you need is a Telegram account.


  • /start the bot
  • Ask for /help for further information
  • Ask for /ciclopi information

"Server" side

You may choose between method 1 (pip) and method 2 (git).

  1. Using pip
    • Install ciclopibot
    pip install ciclopibot
    • Run ciclopibot as module
    python -m ciclopibot -h  # Get help 
    python -m ciclopibot <your_token_here>
  2. Using git
    • Clone this repository
    git clone ssh://
    # git clone
    # git clone
    # git clone
    • Run it will help you perform the following operations.
      • Put a Telegram bot token in gitignored data/ module.
        • To get a token, ask @BotFather.
        • The bot whose token you use will act as @CicloPiBot as long as you run the script.
      • Create a python3.5+ virtual environment and install requirements.
      • Specify python_virtual_environment and python_script variables in
    • Run
    • You may edit the file and test your code with your bot.
    • Should you be satisfied of your edits enough, you may fork this repository and open a pull request.


  • Davte is the creator and the main author of this repository.
  • All data are obtained from CicloPi website and are meant to help users save time when using their service. Misuse is discouraged.
  • Minala inspired the idea and gave a first version of this service many years ago with a different implementation.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ciclopibot-1.2.6.tar.gz (19.8 kB view hashes)

Uploaded source

Built Distribution

ciclopibot-1.2.6-py3-none-any.whl (19.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page