A command-line interface tool for working with Databao Agent and Databao Context Engine

Website • Quickstart • Docs • Discord

Databao CLI is available on PyPI and can be installed with uv, pip, or another package manager.

uv add databao

pip install databao

1. Create a project directory and navigate to it:

   mkdir databao-project && cd databao-project

   [!TIP] Databao is not terminal-only. If you prefer the web interface, run databao app in your project directory.

2. Initialize the project:

   databao init

3. When prompted, agree to configure a domain – a dedicated space where data context, context, and agent chats live.

   Then follow the prompts to add one or several data sources.

4. Build context:

   databao build

5. Pass your API key as an environment variable:

   # OpenAI or OpenAI-compatible APIs
   export OPENAI_API_KEY=<your-key>
   
   # Anthropic Claude
   export ANTHROPIC_API_KEY=<your-key>

6. Run the Databao Agent:

   databao ask

7. Ask questions about your data:

   # Example questions:
   What is our refund rate by month?
   What is our 90-day repeat purchase rate
   

For more details about commands, supported data sources, and configuration options, visit the docs.

# Tag and push a specific version (CI publishes to PyPI)
make release VERSION=0.3.0

# Bump the patch version automatically (e.g. 0.3.0 -> 0.3.1)
make patch-release

# Bump the minor version automatically (e.g. 0.3.1 -> 0.4.0)
make minor-release

# Bump the major version automatically (e.g. 0.4.0 -> 1.0.0)
make major-release

# Trigger a dev release via GitHub Actions
make dev-release

We love contributions! Here’s how you can help:

• ⭐ Star this repo — it helps others find us!
• 🐛 Found a bug? Open an issue
• 💡 Have an idea? We’re all ears — create a feature request
• 👍 Upvote issues you care about — helps us prioritize
• 🔧 Submit a PR
• 📝 Improve docs — typos, examples, tutorials — everything helps!

New to open source? No worries! We’re friendly and happy to help you get started.

Apache 2.0 — use it however you want.

See the LICENSE file for details.

Like Databao? Give us a ⭐! It will help to distribute the technology.

Website • Docs • Discord