Skip to content

Contributing

Your contributions are highly appreciated!

Prerequisites

Before proceeding, ensure the following tools and credentials are set up:

Tip

Once uv is installed, you can easily install pre-commit by running: 

uv tool install pre-commit

  • Set up pre-commit hook: 
    pre-commit install --install-hooks
  • Generate an OpenAI API Key:
    1. Create an openai account.
    2. Visit the API key page.
    3. Generate a new secret key.
      You'll need this key in the setup section below.

Installation and Setup

To run timecopilot in your local environment:

  1. Fork and clone the repository: 
    git clone git@github.com:<your username>/timecopilot.git
  2. Navigate into the project folder: 
    cd timecopilot
  3. Install the required dependencies for local development: 
    uv sync --frozen --all-extras --all-packages --group docs
  4. Export your OpenAI API key as an environment variable: 
    export OPENAI_API_KEY="<your-new-secret-key>"
  5. Test timecopilot with a sample forecast: 
    uvx timecopilot forecast https://otexts.com/fpppy/data/AirPassengers.csv

✅ You're ready to start contributing!

Running Tests

To run tests, run:

uv run pytest

Documentation Changes

To run the documentation page in your local environment, run:

uv run mkdocs serve

Documentation Notes

  • Each pull request is tested to ensure it can successfully build the documentation, preventing potential errors.
  • Merging into the main branch triggers a deployment of a documentation preview, accessible at preview.timecopilot.dev.
  • When a new version of the library is released, the documentation is deployed to timecopilot.dev.

Adding New Datasets

The datasets utilized in our documentation are hosted on AWS at https://timecopilot.s3.amazonaws.com/public/data/. If you wish to contribute additional datasets for your changes, please contact @AzulGarza for guidance.

Forked Dependencies

TimeCopilot uses some forked Python packages, maintained under custom names on PyPI: