Missing an installation? submit a
new installation request and we will add it as soon as we can.
We recommend to install Keep CLI with Python version 3.11 for optimal compatibility and performance.
This choice ensures seamless integration with all dependencies, including pyarrow, which currently does not support Python 3.12
Need Keep CLI on other versions? Feel free to contact us!
Clone and install (Option 1)
Install
First, clone Keep repository:
git clone https://github.com/keephq/keep.git && cd keep
Install Keep CLI with pip
:
# MacOS if python or pip not present:
# brew install [email protected]
# brew install postgresql
pip3.11 install .
or with poetry
:
From now on, Keep should be installed locally and accessible from your CLI, test it by executing:
Configuration
To get API key, check Keep UI -> your username (bottom left) -> Settings -> API Keys
keep config new --url http://backend.my_keep.my_awesome_org.com:backend_port --api-key your_personal_api_key
Test
Now,
keep workflow apply -f examples/workflows/query_clickhouse.yml
Congrats 🥳 Check your UI for the new workflow uploaded from the YAML file.
Docker image (Option 2)
Install
docker run -v ${PWD}:/app -v ~/.keep.yaml:/root/.keep.yaml -it us-central1-docker.pkg.dev/keephq/keep/keep-cli keep config new --url http://backend.my_keep.my_awesome_org.com:backend_port --api-key your_personal_api_key
Test
docker run -v ${PWD}:/app -v ~/.keep.yaml:/root/.keep.yaml -it us-central1-docker.pkg.dev/keephq/keep/keep-cli workflow apply -f examples/workflows/query_clickhouse.yml
Enable Auto Completion
Keep’s CLI supports shell auto-completion, which can make your life a whole lot easier 😌
If you’re using zsh
eval "$(_KEEP_COMPLETE=zsh_source keep)"
If you’re using bash
eval "$(_KEEP_COMPLETE=bash_source keep)"
Using eval means that the command is invoked and evaluated every time a shell is started, which can delay shell responsiveness. To speed it up, write the generated script to a file, then source that.
Responses are generated using AI and may contain mistakes.