MCPcopy Index your code
hub / github.com/datasparq-ai/houston

github.com/datasparq-ai/houston @v0.8.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.8.1 ↗ · + Follow
243 symbols 808 edges 29 files 104 documented · 43%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Houston

Open source, API based workflow orchestration tool.

Houston Flowchart

This repo contains the API server, go client, and CLI.

Example Usage

Houston CLI

Start a local server with the default config: houston api

Quickly run an end-to-end example workflow: houston demo

Or use the Docker container: docker run -p 8000:8000 datasparq/houston-redis demo

See the quickstart for a guide on how to create microservices and complete Houston missions using them: quickstart

Install

You can download the binary from the releases page.

If you have go installed you can install with:

go install github.com/datasparq-ai/houston@latest

Why Houston?

Houston is a simpler, faster, and cheaper alternative to tools like Airflow.

API based orchestration comes with 5 key advantages: 1. Code can run on serverless tools: lower cost, less maintenance, infinite scale 2. The server isn't under heavy load, so can handle hundreds of concurrent missions 3. Pub/Sub message delivery is guaranteed, improving reliability 4. Multiple workflows can share the same task runners, aiding collaboration 5. Task runners can run anywhere in any language, allowing for rapid development with no vendor lock-in

Contributing

Please see the contributing guide.

Development of Houston is supported by Datasparq.

Extension points exported contracts — how you extend this code

Database (Interface)
Database represents the store of API Keys, Missions, and Plans in either Redis or a local in memory database all databas [2 …
database/database.go

Core symbols most depended-on inside this repo

Get
called by 47
database/database.go
Error
called by 36
model/errors.go
Set
called by 31
database/database.go
handleError
called by 28
api/util.go
GetStage
called by 15
mission/mission.go
New
called by 13
client/client.go
NewFromJSON
called by 13
mission/mission.go
Validate
called by 13
mission/mission.go

Shape

Method 140
Function 60
Struct 38
TypeAlias 4
Interface 1

Languages

Go100%

Modules by API surface

mission/mission.go20 symbols
client/client.go20 symbols
api/api.go16 symbols
model/errors.go15 symbols
database/database.go13 symbols
model/model.go12 symbols
database/redis_db.go12 symbols
database/local_db.go12 symbols
mission/mission_test.go11 symbols
main_test.go11 symbols
api/router-middleware.go11 symbols
client/interface.go9 symbols

For agents

$ claude mcp add houston \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page