PyTM - Logo

PУΓM - A CLI time tracker for projects with invoice generation

image1 Documentation Status Supported Python Versions List of Contributors Download Stats Documentation Status image2


Project time management, billing, and invoice generation.


PyTM - Preview


PyTM - Screenshot PyTM - Invoice

Installing PyTM

  • First download and install pyenv. Use the command:

    curl | bash
  • Next, install Python 3.12 using the command:

    pyenv install 3.12.0

    Alternatively, you can skip pyenv installation and download python 3.12 or above from the official website and setup a virtualenv as well.

  • Next, install PyTM from PyPI using pip:

    python -m pip install python-pytm

Check the version by typing the following in your terminal.:

pytm --version

Basic commands

To see the available commands type:

pytm --help


Configure project, user and invoice info:

pytm config project PROJECT_NAME
pytm config user
pytm config invoice

Generate Invoice:

pytm invoice auto PROJECT_NAME
pytm invoice manual

Check version:

pytm --version
pytm -v

Check summary of all the projects:

pytm summary

For a list of all the available commands try:

pytm --help

Running the tests

  • Clone this repository

  • Install dependencies:

    pip install -r requirements.txt
  • run the tests:





If you have any suggestions or questions about PyTM feel free to email me at

If you encounter any errors or problems with PyTM, please let me know! Open an Issue at the GitHub main repository.