git404hub

what is sturna fr?

tylerbroqs/sturna — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

tl;dr

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

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

TypeScriptNode.jsHonoVitestMCP

how it stacks up fr

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 i run it?

Difficulty · moderate time til it works · 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.

in plain english

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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.