# turnstonelabs/turnstone

Repository: https://github.com/turnstonelabs/turnstone
Canonical: https://ross.abutalabs.com/products/turnstone
Language: Python
License: Apache-2.0
License Family: permissive
Last push: 2026-09-02T20:14:27+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 100, release rhythm 87, longevity 13
- inputs: {"age_days": 184, "days_push": 0, "days_rel": 11, "gap_med": 0, "n_releases_24m": 74}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1239, forks 92 (observed 2026-09-03T02:15:20.026156+00:00)

## What it is
Turnstone is a self-hosted, local-first orchestration platform for tool-using AI agents, letting LLMs use real tools like shell, files, search, and web across your own cluster. It provides direct HTTP routing, interactive interfaces, and multi-node agent routing with no telemetry or phone-home.

## Use cases
- run tool-using AI agents on my own hardware
- self-host an LLM agent orchestration platform
- give AI agents shell and file access locally
- route AI agents across a multi-node cluster
- orchestrate parallel AI agent workloads without telemetry
- build a local-first agent harness with tool use

## When to choose
- you want full control over your data, models, and hardware with no telemetry
- you need multi-node agent orchestration with tool use
- you prefer self-hosted infrastructure over cloud agent platforms
- you want direct HTTP routing and interactive agent interfaces

## When to avoid
- you want a fully managed cloud agent service
- you need a lightweight single-script agent without cluster features
- you require vendor-managed scaling and support

## Facets
- artifact type: framework
- maturity: active
- function: agent-framework, llm-inference, chatbot, webhook, self-hosted
- domain: large-language-models, self-hosted, developer-tools
- platform: python, self-hosted, cross-platform
- tags: ai-agent-orchestration, tool-use, local-first, multi-node, agent-harness, cluster-simulation, no-telemetry, ai-agents, automation, docker, linux, macos

## Member repositories
- turnstonelabs/turnstone (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:20.026156+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:22:11.144726+00:00, confidence not recorded.
  - readme: https://github.com/turnstonelabs/turnstone (fetched 2026-09-03T02:15:20.026156+00:00, sha e526264a94dc)
  - registry_pypi: https://pypi.org/pypi/turnstone/json (fetched 2026-08-29T12:29:30.761866+00:00, sha 6c42d1f34b26)
- Data as of 2026-08-30T08:39:29.467469+00:00.