Show HN: Banksia – Build and run adaptable, accountable AI teams

Notifications You must be signed in to change notification settings

Fork 0

Star 5

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

65 Commits

65 Commits

.agents/standards

.agents/standards

console

console

docs-internal

docs-internal

docs

docs

examples

examples

infra

infra

openapi

openapi

scripts

scripts

src/banksia

src/banksia

tests

tests

.dockerignore

.dockerignore

.editorconfig

.editorconfig

.env.example

.env.example

.gitignore

.gitignore

AGENTS.md

AGENTS.md

CONTRIBUTING.md

CONTRIBUTING.md

LICENSE

LICENSE

Makefile

Makefile

README.md

README.md

STYLE.md

STYLE.md

docker-compose.yml

docker-compose.yml

pyproject.toml

pyproject.toml

pyrightconfig.json

pyrightconfig.json

Repository files navigation

Build adaptable, accountable AI teams in minutes—and run them on complex work.

Design them easily, run them reliably, and stay in control from the first decision to the final Result.

Get started · Documentation · Starter teams

Watch the Banksia tutorial

Install and start

Banksia requires Python 3.12 or newer and currently supports Linux and macOS. Install the command-line application in an isolated environment with pipx:

pipx install banksia banksia init banksia serve

Open http://127.0.0.1:18125/. The installed package includes the visual Console. Guided initialization chooses a default workspace, configures a Task provider, and can configure the separate Operator that helps you build and run teams.

Banksia uses SQLite by default, so a local installation needs no database server. For PostgreSQL, install the optional driver and supply a SQLAlchemy URL during initialization:

pipx install "banksia[postgres]" banksia init \ --database-url "postgresql+asyncpg://[email protected]/banksia"

See Getting started for provider prerequisites and a complete first run, or Database configuration for PostgreSQL permissions, schemas, and environment overrides.

Design and operate visually

The Console is the primary Banksia experience. It keeps the common path no-code while preserving advanced provider, sandbox, and capability controls when a team needs them.

Workflow library makes reusable teams and drafts easy to find, compare, start, or remove.

Workflow Studio shows the complete responsibility hierarchy on a horizontal canvas. Add a child with one +, select any Member to edit its purpose and instructions, validate the draft, and publish an immutable revision explicitly.

Run Studio shows the live team, current plan, meaningful Activity, requests that need your attention, managed Actions, referenced files, and the exact completed or blocked Result.

The Operator is a separate conversational agent inside the Console. Ask it to draft or revise a Workflow, explain the current team, validate and publish when you request it, start and control Runs, answer Human Requests, or inspect managed Action output. It uses the same controller-owned operations as the visual interface, so chat does not create a second hidden source of truth.

Why Banksia

Banksia makes complex multi-agent work easier to create, adapt, recover, and trust:

Create an AI team easily. Use the visual Console or conversational Operator to shape, publish, and run a reusable team.

Let the team adapt how it works. Managers choose sequential, parallel, iterative, batch, or hybrid work from the Task and current evidence.

Keep complex work moving. Durable state lets eligible work pause, wait, replan, retry safely, recover, and resume without discarding accepted history.

Stay accountable from start to Result. Follow explicit responsibility, team revisions, decisions, Activity, referenced files, managed Actions, and the one Result accepted by the lead.

What a team can do

A Workflow defines reusable responsibility rather than a fixed schedule. You publish a team, give its lead one complete prompt, and let each Manager choose the approach that fits the work. If the current team itself no longer fits, a bounded replan changes its responsibility tree while preserving earlier revisions and completed work.

Delegate through a responsibility tree without forcing a fixed sequence into the Workflow.

Combine independent research, implementation, criticism, integration, and verification.

Ask you a typed question when an authorized Member genuinely needs a decision.

Run a managed command when the Workflow explicitly grants that capability.

Replan a current responsibility subtree without rewriting the Task's earlier team or work history.

Preserve progress across browser or provider interruption.

Return one human-readable Result with direct references to detailed workspace files.

Capabilities deny by default and never inherit from a parent. Provider, model, sandbox, and capability choices remain available when a team needs them, without making them mandatory for every Workflow.

Upgrade ad-hoc delegation

If you already coordinate subagents by hand, Banksia turns those recurring delegation patterns into reusable teams without making subagents the product boundary:

Ad-hoc subagents Banksia

Recreate roles and prompts for every job Publish a reusable tree of named responsibilities

Reconstruct ownership from a transcript Follow controller-owned team, activity, and wait state

Treat provider completion as the outcome Accept only the lead's final green or blocked Result

Recover by piecing together terminal sessions Recover from durable controller records; keep deliverables in ordinary workspace files

Start with a proven team

banksia init publishes eight provider-neutral Starters. Choose one when the work is consequential or broad enough that independent responsibility can improve the outcome:

Starter Use it when

production-feature-delivery A feature crosses contracts, implementation boundaries, integrated verification, and release readiness.

incident-investigation-and-recovery A serious or intermittent failure needs competing hypotheses, supported recovery, verification, and prevention.

migration-and-modernisation A large migration needs inventory, dependency-aware batches, cutover, and stale-path removal.

deep-research-and-decision-brief A consequential question needs independent evidence, claim verification, and one accountable recommendation.

decision-through-competing-prototypes Alternatives should be tested under one fair rubric instead of decided from prose alone.

idea-to-validated-demo A product idea should become an evidence-backed position, working first demo, launch strategy, and credible pitch.

experiment-and-replication-program An empirical or computational program needs explicit methods, durable execution, independent replication, and claim audit.

security-audit-and-hardening A security program needs attack-surface mapping, specialised audits, validated remediation, and adversarial re-verification.

The Starter catalog includes example missions, expected deliverables, and guidance on when a simpler team is better.

How a run works

Choose or design a team. Start from a Starter or shape a responsibility tree in Workflow Studio.

Publish a stable revision. Every run keeps the exact team contract it started with.

Give the lead one complete prompt. The team plans, delegates, adapts, and records meaningful progress while detailed work stays in ordinary workspace files.

Follow the work and receive the Result. Answer real Human Requests, inspect managed Actions, and read the lead's exact final outcome.

Know before you start

Banksia is best suited to complex developer and researcher work on a trusted local machine. The controller runs as one loopback-bound process, and every Member in a Task shares one provider-visible workspace.

Codex and Claude are managed providers. OpenClaw is a user-operated compatibility transport. Native Windows is not currently supported; WSL2 uses the Linux path. External MCP servers, reusable Skills, distributed delivery, broad multi-user operation, and per-Member isolated workspaces are outside the current product boundary.

Documentation

Getting started

Understand Workflows and teams

Author a Workflow

Run and operate work

Use the Console and Operator

Configure Banksia

Troubleshoot an installation

Contribute

Report an issue

Banksia is open source under the MIT License, except for the visual Console in console/, which contains material derived from n8n and is distributed under the Sustainable Use License. That license permits internal business, non-commercial, and personal use; redistribution is limited to free, non-commercial distribution. See the Console notice for attribution and the modification notice.

Resources

Readme

MIT license

Contributing

Contributing

Activity

Stars

5 stars

Watchers

1 watching

Forks

0 forks

Report repository