whatisgithub

What is sturna?

tylerbroqs/sturna — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A simulated investment desk where six AI agents work together to research, build, and rebalance a portfolio of tokenized private-market assets.

Mindmap

mindmap
  root((Sturna))
    What it does
      Six agent investment desk
      Sources and scores assets
      Builds and rebalances basket
    Tech stack
      TypeScript core
      Hono API server
      Robinhood MCP
    Use cases
      Simulated paper trading
      Backtest mandates
      Go live via Robinhood MCP
    Audience
      Developers
      AI agent researchers
    Setup
      npm install then npm run server
      Paper mode by default
      Live mode needs credentials

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a simulated multi-agent investment desk in paper mode with no real money at risk.

USE CASE 2

Backtest different investment mandates over a simulated year of weekly rebalances.

USE CASE 3

Study a reference implementation of a multi-agent decision pipeline.

USE CASE 4

Wire the engine to Robinhood's agentic trading MCP to place real orders once ready.

What is it built with?

TypeScriptNode.jsHonoVitestMCP

How does it compare?

tylerbroqs/sturna0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity4/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Paper mode runs immediately after npm install, going live requires a Robinhood Agentic Account and an MCP token.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Sturna is an open source engine that simulates an investment desk run entirely by six AI agents. Each agent owns one step of the process: Scout finds eligible assets from a tokenized universe of private-market and real-world assets, Analyst scores each one on growth, quality, momentum, liquidity and thesis fit, Architect builds a weighted basket while respecting risk caps, Sentinel independently checks the plan against risk limits and can halt the whole cycle if something looks too risky, Executor turns approved decisions into trade orders, and Steward marks the resulting portfolio to market and watches for drift afterward. By default the project runs in paper mode, meaning every trade is simulated with no real money at risk. It is built to work with Robinhood's official agentic trading MCP, a Model Context Protocol interface, so it can be switched to place real orders once you provide the right credentials, though the README is explicit that this is a research and education project and not investment advice. The code is written in TypeScript with no framework dependencies in its core, so it can run in Node or directly in a browser. You install it with npm, then either start an HTTP API server, run a single cycle from the terminal, or run the unit tests. It also includes a backtesting command that replays a simulated year of weekly rebalances and compares results across different investment mandates, with reproducible results when you set the same random seed. Developers can use every agent as an importable function in their own code, and the repository includes example projects showing a custom agent pipeline and the whole swarm running inside a plain browser page. The project is licensed under MIT.

Copy-paste prompts

Prompt 1
Explain what each of Sturna's six agents does in the investment pipeline.
Prompt 2
Help me run Sturna's backtest command and interpret the mandate comparison output.
Prompt 3
Walk me through connecting Sturna to Robinhood's agentic trading MCP for live trading.
Prompt 4
Show me how to write a custom agent and splice it into Sturna's swarm cycle.
Prompt 5
What does paper mode mean in Sturna and how is it different from live trading?

Frequently asked questions

What is sturna?

A simulated investment desk where six AI agents work together to research, build, and rebalance a portfolio of tokenized private-market assets.

What language is sturna written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Hono.

What license does sturna use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is sturna to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is sturna for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.