​
Install Sage

First, make sure that pipx is installed in your environment. Then install Sage:

pipx install git+https://github.com/Storia-AI/sage.git@main

​
Setup API keys

By default, Sage uses Anthropic’s Claude model as the underlying LLM. Grab an API key from your account settings and export it to an environment variable:

export ANTHROPIC_API_KEY=...

If your GitHub repository is private, then you will also need a personal access token. This is not necessary for public repositories.

export GITHUB_TOKEN=...

​
Chat with any codebase

You are now ready to chat with your codebase. Simply pass the repository name to the sage-chat command, in the repo-org/repo-name format. For instance, in order to chat with Hugging Face’s Transformers library:

sage-chat huggingface/transformers

This will bring up a Gradio UI that runs on localhost. Happy chatting!

Running locally