Open Source RoboSystems

Build powerful financial analysis tools with SEC filings, graph databases, and AI integration. Deploy locally or to AWS with complete infrastructure automation.

Get Started with RoboSystems

Clone the repository and run the complete stack locally or deploy to AWS

Quick Start - Docker Development Environment

Complete stack with all services configured

The recommended way to run RoboSystems. Includes PostgreSQL with automatic migrations, graph database, Valkey message broker, and all development services pre-configured.

# Clone the repository
git clone https://github.com/RoboFinSystems/robosystems.git
cd robosystems

# Install uv (Python package and version manager)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install just (command runner)
uv tool install rust-just

# Start all services (includes automatic migrations and seeds)
just start

# Services available at:
# API: http://localhost:8000
# Docs: http://localhost:8000/docs

Powerful Use Cases

From SEC financial analysis to AI-powered insights, build sophisticated financial applications with RoboSystems

SEC XBRL Pipeline

Load and query financial filings locally

Load company financial filings (10-K, 10-Q) by ticker symbol into a local graph database. Query revenue, net income, assets, and other GAAP metrics across multiple years with Cypher queries.

What You Can Do:

✓Download and process SEC filings for any public company
✓Query financial metrics using Cypher graph database language
✓Integrate with Claude Desktop or Claude Code via MCP
✓Access programmatically via Python or TypeScript clients
✓Compare financials across companies and time periods

Quick Start - Load NVIDIA Filings:

# Start RoboSystems services
just start

# Create a test account with SEC access
just db-create-test-user sec

# Load NVIDIA filings (all available years)
just sec-load NVDA

# Query revenue data
just graph-query sec "MATCH (e:Entity)-[:ENTITY_HAS_REPORT]->(r:Report) RETURN r LIMIT 5"

View Full SEC Pipeline Documentation →

AI Integration via MCP

Connect Claude Desktop, Claude Code, or any MCP client

Use the Model Context Protocol (MCP) to give AI assistants direct access to your financial data. Ask questions in natural language and let Claude query your knowledge graph automatically.

Integration Options:

✓Claude Desktop:Add to your config for conversational financial analysis
✓Claude Code:Query financial data while coding and building applications
✓Custom MCP Clients:Build your own AI-powered financial tools

Claude Desktop Configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "robosystems": {
      "command": "npx",
      "args": ["-y", "@robosystems/mcp"],
      "env": {
        "ROBOSYSTEMS_API_URL": "http://localhost:8000",
        "ROBOSYSTEMS_API_KEY": "rfs_your_api_key_here",
        "ROBOSYSTEMS_GRAPH_ID": "sec"
      }
    }
  }
}

Example Questions You Can Ask Claude:

•"What was Apple's revenue for the last 5 years?"
•"Compare NVIDIA and AMD net income trends"
•"Show me Tesla's total assets by quarter"
•"What are the most recent earnings per share for Microsoft?"

Client Libraries & SDKs

Install RoboSystems client libraries for your preferred programming language

TypeScript / JavaScript

Official TypeScript client with React components and hooks.

npm install @robosystems/client

npm →GitHub →

Python

Python client library with Jupyter notebook support.

pip install robosystems-client

PyPI →GitHub →

MCP Client

Model Context Protocol client for AI agent integration.

npx -y @robosystems/mcp

npm →GitHub →

Optional: Production Deployment

Deploy to AWS

Ready for production? GitHub Actions and CloudFormation templates provide complete AWS infrastructure automation

AWS CloudFormation

Infrastructure as Code Templates

Complete AWS infrastructure defined as code. Deploy a production-ready environment with auto-scaling, load balancing, and managed services in minutes.

Included Resources:

✓ECS Fargate cluster with auto-scaling
✓Application Load Balancer with SSL/TLS
✓RDS PostgreSQL with Multi-AZ deployment
✓ElastiCache Valkey for session management
✓Prometheus, CloudWatch, and Grafana observability
✓S3 buckets for graph backup storage
✓CloudFront CDN for global distribution
✓Route 53 DNS with health checks

View CloudFormation Templates →

GitHub Actions CI/CD

Automated Deployment Pipelines

Complete CI/CD pipeline that orchestrates CloudFormation deployments. The production workflow automatically deploys your entire infrastructure stack to AWS.

Integrated Deployment Pipeline:

✓CloudFormation stack deployments
✓Production and staging environments
✓Self-hosted runner available
✓Test suite validation before deployment
✓Docker image building and ECR push
✓Lambda function packaging and deployment
✓Database migrations workflow
✓GitHub deployment status monitoring

View GitHub Actions Workflows →

Deploy Your Own RoboSystems in Minutes

Fork our repository and have your own production environment running on AWS

Fork Repository

Click "Fork" on GitHub to create your own copy of the RoboSystems codebase

Configure AWS

Add your AWS credentials as GitHub Secrets for automated deployment

Deploy Infrastructure

Trigger the production workflow and watch CloudFormation stacks deploy automatically

Fork on GitHub View Documentation

Ready to Deploy Your Own Financial Knowledge Graph?

Fork our repository and have your production environment running in minutes

Fork on GitHub View on GitHub