Slack-nativeAvailable via MCPRead-only by design

The AI data analyst
your team actually owns.

Ask in Slack, on Mac, or via MCP. Byaan learns your business once — your whole team runs it as skills. Read-only by design.

Download for Mac Star on GitHub Read the docs →

Free Mac app · MIT licensed · Self-host the team version · AGPL

#analytics · slackMac appClaude Code

User10:42 AM

@byaan monthly revenue by product line for Q4, save as q4-revenue-deck

Loading skills · checking fct_revenue · fiscal year starts Feb 1

ByaanAPP10:42 AM

Q4 revenue reached $2.4M across 3 product lines. Enterprise led with 48% share, up +18.7% YoY. Saved as skill @byaan q4-revenue-deck

Q4 revenue · by product lineskill saved

↗ Open⤓ PDF⎘ Excel

Total Revenue

$2.4M

↑ 12.3%

Data agents fail because
they lack context

Generic AI doesn't know your schema, your definitions, or your edge cases. Every session starts from zero.

"What does revenue mean here?"

Every company defines metrics differently. Generic AI doesn't know your fiscal calendar, your refund policy, or which subscriptions count.

"Which table is the source of truth?"

Your data lives across dozens of tables and a few materialized views that lie. AI picks the wrong one more often than not.

"Can I trust this answer?"

A confident wrong answer is worse than no answer. Most AI data tools start from zero every session — no memory, no audit trail.

The fix

Byaan solves this
by giving you control

Accurate memory across your organization

Byaan learns your schema, metric definitions, and edge cases once — then saves them as skills the whole org runs correctly every time. New hires inherit the memory your senior analyst spent six months building. Connect GitHub and Byaan reads your codebase to understand the intent behind your data.

Learns once, consumed correctly by everyone
Connect GitHub — Byaan reads code to understand intent
Same skills work in Slack, Mac, and MCP clients

skills.yaml● synced

# context Byaan learned about your teamcontext:revenue: "SUM(line_items.amount) WHERE status='paid'"fiscal_year: "starts February 1"truth_table: "fct_revenue (not mv_revenue_monthly)"refunds: "deducted in same month as charge"# named skills your whole team can runskills:q4-revenue-deck: "quarterly revenue + cohorts → PDF"churn-watchlist: "alert when weekly churn > 4%"cohort-retention: "monthly cohorts by signup channel"

You own the data, end to end

The Mac app runs locally — no signup, no cloud. The team version self-hosts in your infrastructure. Credentials, queries, and results never leave where you put them. Read-only by design means Byaan can't break production.

Mac app — free, MIT licensed
Team version — self-hosted, AGPL licensed
Your credentials never leave your network

data flow · where things live

Mac App

Runs locally · zero telemetry · MIT licensed

free

Team Version

One-line install · auth · Slack · HTTPS

team

Read-only by design

No DDL · No DML · Safe on production

safe

network egress · last 24h0 bytes

💻 your laptop✓ your network

queries leaving your network0

Bring your own AI model

Use your company's federated AI — Azure, Bedrock, Anthropic, OpenAI, Groq, OpenRouter, xAI. Your keys, your billing. Switch any time without losing your skills or context.

Works with any OpenAI-compatible API
No external calls outside the provider you pick
Switch providers without losing your skills or context

~/.byaan/providers.envBYOM

Anthropic

Claude — direct API

active

Azure OpenAI

your tenant · your billing

configured

AWS Bedrock

in-VPC inference

configured

OpenAI · Groq · xAI

any OpenAI-compatible endpoint

supported

Workflow

How teams use Byaan

Five steps from question to shareable answer. Same context wherever your team works.

Ask anywhere

Slack, the Mac app, or any MCP client — Claude Code, Cursor, Codex. Same Byaan, same context.

Slack · Mac · MCP

Byaan learns the right answer once

Your schema, metric definitions, fiscal calendar, edge cases — saved to organizational memory. Connect GitHub and Byaan reads your codebase to understand intent.

Persistent · GitHub-aware

The whole team consumes it correctly

Turn complex workflows into one-line commands: @byaan cohort-retention. Same logic, same definitions, every time. Versioned, named, shared.

Versioned · shared

Build dashboards and reports

Interactive dashboards, PDF reports, Excel exports, standalone HTML. No backend needed to view.

PDF · Excel · HTML

Run it your way

Free Mac app for individuals. One-line install for teams — auth, Slack, and HTTPS included.

Mac · One-line install

Features

Everything you need,
nothing you don't

Built for engineers who need answers — not another tool to manage.

Organizational memory

Schema, definitions, fiscal calendars, edge cases — learned once, consumed correctly across the team.

Shared skills

Memory becomes named skills. One line, same accurate answer every time.

Available via MCP

Use Byaan from Claude Code, Cursor, Codex, or any MCP client. Same skills, same context.

Slack-native

@byaan in any channel. Threaded answers everyone sees. Reports inline.

GitHub-aware

Connect your repo — Byaan reads code to understand the intent behind your data: column meanings, business rules, naming conventions.

Multi-database

PostgreSQL, MongoDB, MySQL, MSSQL, SQLite. Plus CSV, Excel, Parquet, JSON.

Bring your own model

Anthropic, OpenAI, Azure, Bedrock, Groq, OpenRouter, xAI. Your keys, your infra.

Read-only by design

Never executes DDL or DML. Validation blocks writes across SQL, Mongo, DuckDB.

For teams

Byaan Team Version

One-line install. Multi-user auth, RBAC, Slack, and automatic HTTPS — out of the box. Runs in your VPC. AGPL licensed.

5-minute install

Linux + Docker · 2 GB RAM (4 GB recommended) · ports 80/443 or 8080 free

Install

click to run

curl -fsSL https://downloads.byaan.ai/docker/install.sh | bash

Drops start.sh and .env into ./byaan. APP_SECRET is auto-generated.

Configure

Open .env and set:

MASTER_USER_EMAIL — admin email
MASTER_USER_PASSWORD — 8+ characters
ORG_NAME — your organization
DOMAIN (optional — enables Let's Encrypt HTTPS)

Start

./start.sh

Live on :8080 (or your DOMAIN). Sign in as the master admin you configured, then invite teammates from the admin panel.

[+] Downloading start.sh, .env, README.md→ APP_SECRET generated · edit .env, then ./start.sh✓ Byaan running on http://localhost:8080postgres · backend · caddy · supervisord — one container

Update & logs

Keep your instance current and monitor services with these commands.

↑

Update

./start.sh update

Run this command to deploy the latest version.

≡

Logs

./start.sh logs

Tail all services. Scope to one service by passing its name:

./start.sh logs backend — FastAPI
./start.sh logs caddy — reverse proxy
./start.sh logs postgres — database

●

Status

./start.sh status

Check whether Byaan is running.

Multi-user auth + RBAC

Invite teammates by email, assign roles. Master admin created on first run.

Slack integration

Add to your workspace. Tag @byaan in any channel — answers in the thread.

Google OAuth

Drop in client ID and secret to enable SSO. Optional.

Automatic HTTPS

Set DOMAIN in .env — Caddy fetches a Let's Encrypt cert. No proxy config.

Zero-downtime updates

Blue-green deploys on ./start.sh update. Optional auto-update nightly.

Shared dashboards

Notebooks, dashboards, and skills shared across your org.

Read the team version docs Star on GitHub

AGPL licensed · Your VPC, your keys · Optional Let's Encrypt HTTPS · Blue-green updates

Questions, answered

If something's not here, ask in GitHub Discussions.

Is Byaan open source?

The team-hosted version will be released under AGPL-3.0. The Mac app is MIT licensed. Both are going public on GitHub soon — you can star github.com/byaan-ai/byaan to follow the launch.

Is my data safe?

Yes. The Mac app runs entirely on your machine — credentials, queries, and data never leave your computer. The team version is self-hosted, so the same is true at team scale. Byaan is also read-only by design: it never executes DDL or DML, so production databases are safe.

What is "Bring Your Own Model"?

Byaan works with any OpenAI-compatible API. Connect Anthropic, OpenAI, Azure OpenAI, AWS Bedrock, Groq, OpenRouter, or xAI. Your API keys stay on your machine or in your team deployment. Switch models any time.

How does Byaan build organizational memory?

Byaan explores your schema, learns from your corrections, and saves metric definitions to org memory. Any workflow becomes a named skill — @byaan q4-deck is a one-line command your whole team can run.

Can Byaan understand my codebase?

Yes. Connect a GitHub repo (or a local repo if you're on the Mac app) and Byaan reads the code to understand the intent behind your data — column meanings, business rules, naming conventions, the relationships your tables actually represent. This is one of the strongest signals for accurate answers.

What databases does Byaan support?

PostgreSQL, MongoDB, MySQL, MariaDB, SQLite, MSSQL. You can also upload CSV, Excel, Parquet, and JSON files directly.

What is MCP and how does Byaan use it?

MCP (Model Context Protocol) is the open standard for connecting AI tools. Byaan exposes an MCP server, so you can use it from Claude Code, Cursor, Codex, or any MCP-compatible client — with your full skill library and learned context intact.

How does the Slack integration work?

Add Byaan to your workspace, mention @byaan in any channel or thread, and ask a question. Answers, charts, and reports appear inline so everyone in the channel sees them. Skills work in Slack just like in the Mac app.

How do I deploy the Byaan Team Version?

One line: curl -fsSL https://downloads.byaan.ai/docker/install.sh | bash. The installer drops a start.sh and .env in a byaan directory. Set your admin email, password, and org name in .env, then run ./start.sh. PostgreSQL, backend, frontend, and Caddy ship in a single container — you're live on port 8080 in five minutes. Set DOMAIN for automatic HTTPS via Let's Encrypt.

Three ways to start with Byaan

Pick the path that fits how you work today. You can switch later — your skills come with you.

Individuals

Download for Mac

Free. MIT-licensed. Runs on your Mac. No signup, no cloud account, no telemetry on your data.

Download for Mac →

Teams

Team Version

One-line install for your team. Multi-user auth, RBAC, Slack, and HTTPS — out of the box.

Team version docs →

Builders

Follow on GitHub

Track development, file issues, and join discussions. Watch the repo to stay close to what we're shipping.

View on GitHub →

The AI data analystyour team actually owns.

Data agents fail becausethey lack context

Byaan solves thisby giving you control