Eatlocal helps users solve Pybites code challenges locally. This cli tool allows you to download bites from the platform. You can display bite directions directly in the terminal. Once you have solved the bite you can use eatlocal to submit and it offers to open your default browser the corresponding bite page.

• eatlocal
  • Updates
    • Version
    • Breaking Changes
  • Table of Contents
  • Usage
  • Installation
    • macOS/Linux
    • Windows
  • Setup

eatlocal 1.0.0+ has been updated to work with version 2.0 of the PyBites platform.

• Moved the local bites database to a new location. It used to be in the directory set by the user, now eatlocal will look for it in ~/.eatlocal. Run eatlocal init to set the new location.

• Uses the bite slug for the name of the directory.

• eatlocal version 1.0.0 only works on the new platform (v2).
• eatlocal directory no longer has to be a git repository.
• Submitting a bite no longer pushes it to GitHub.
• Bite directories are now names by the bites instead of the number.
• No need to download chrome and chrome driver.
• No more verbose mode

Run eatlocal init to configure your PyBites username, PyBites password*, and local where you will solve your bites.

*Note: If you signed up for PyBites by authenticating through GitHub or Google, you will need to set a password on the platform first.

Set up your email, password, and directory where you will solve your bites. It will also create the local bites database, and the cache database:

eatlocal init

Download bites:

# Show all bites
eatlocal download

# Show only newbie bites
eatlocal download --level newbie

# Show only intro bites
eatlocal download --level intro

# Show only beginner bites
eatlocal download --level Beginner

# Show only intermediate bites
eatlocal download --level Intermediate

# Show only advanced bites
eatlocal download --level Advanced

If you want to force a re-download of a given bite use the --force flag. This will overwrite the bite directory.

eatlocal download --force

By default, eatlocal will cache the bites list and update it every 30 days. If you are not seeing a new bite, then you can clear the cache with the --clear-cache flag.

eatlocal download --clear-cache

Display bites in the terminal:

# change the theme with -t <theme name>
eatlocal display

Submit bites:

eatlocal submit

There are a few options for install eatlocal.

If you have uv installed:

uv tool install eatlocal

If you have pipx installed:

pipx install eatlocal

pip3 install eatlocal

pip install eatlocal

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated, be sure to explore the contributing guide for more information..