RoboSystems App：RoboSystems 金融智能平台 Web 界面开源

RoboSystems App is the web interface for the RoboSystems financial intelligence platform — unifying structured data, document search, and AI-powered insights in one application.

Knowledge Graph Management: Create and manage multiple isolated graph databases with tiered infrastructure
Document Search: Full-text and semantic search across SEC filings, uploaded documents, and connected sources
AI Console: Natural language and Cypher query terminal with streaming results and MCP integration
AI Memory: Browse, edit, and curate the per-graph semantic memory store behind remember/recall
Schema Explorer: Inspect node labels, relationships, constraints, and indexes
Subgraph Workspaces: Create isolated environments for development, testing, and collaboration
Data Lake: DuckDB staging tables for data validation and bulk ingestion
Shared Repository Access: Subscribe to and query SEC XBRL filings and public financial data
Research: Public equity research pages built from SEC filings, every figure traceable to a filing
Backup Management: Create, download, and restore graph database backups
Billing & Usage: Manage subscriptions, view invoices, and track credit usage
Organization Management: Manage team members and organization settings

Quick Start

npm install              # Install dependencies
cp .env.example .env     # Configure environment (edit with your API endpoint)
npm run dev              # Start development server

The application will be available at http://localhost:3000

Development Commands

Core Development

npm run dev              # Start development server (port 3000)
npm run build            # Production build

Testing

npm run test:all         # All tests and code quality checks
npm run test             # Run Vitest test suite
npm run test:coverage    # Generate coverage report

Code Quality

npm run lint             # ESLint validation
npm run lint:fix         # Auto-fix linting issues
npm run format           # Prettier code formatting
npm run format:check     # Check formatting compliance
npm run typecheck        # TypeScript type checking

SDLC Commands

npm run feature:create   # Create a feature branch
npm run release:create   # Create GitHub release
npm run deploy:staging   # Deploy to staging environment
npm run deploy:prod      # Deploy to production

Shared Core Library

Shared components live in the @robosystems/core npm package (repo: robosystems-core). Bump the pinned version to pick up changes:

npm install @robosystems/core@latest

Prerequisites

System Requirements

Node.js 24+ (LTS)
4GB RAM minimum
Modern browser (Chrome, Firefox, Safari, Edge)

Required Services

RoboSystems API endpoint (local development or production)

Deployment Requirements

Fork this repo (and the robosystems backend)
AWS account with IAM Identity Center (SSO)
Run just bootstrap in the backend repo — it deploys OIDC and sets this repository's AWS_ROLE_ARN, AWS_ACCOUNT_ID and AWS_REGION
Run npm run setup:gha here to configure the remaining deployment variables

See the Bootstrap Guide for complete instructions including access modes (internal, public).

Architecture

Application Layer:

Next.js 16 App Router
TypeScript 5 for type safety
Flowbite React with Tailwind CSS for UI components
RoboSystems Client SDK for API communication

Core Library (@robosystems/core):

Shared modules consumed as an npm package across RoboSystems frontend apps:

Auth components (login, register, password reset)
Session management and JWT handling
Graph creation wizard and shared components
Layout, forms, chat, and settings components
Graph, organization, and entity contexts
SSE-based background job progress tracking

Infrastructure:

AWS App Runner or Amazon ECS Express Mode with auto-scaling, chosen by the APP_COMPUTE GitHub variable (apprunner by default; per environment with APP_COMPUTE_PROD / APP_COMPUTE_STAGING). App Runner is closed to new AWS customers, so an account that has never used it must set APP_COMPUTE=ecs-express. Without a default VPC, also set ECS_SUBNETS to comma-separated public subnet IDs in at least two AZs.
S3 + CloudFront for static asset hosting
CloudFormation templates in /cloudformation/

Support

License

Apache License 2.0 - see LICENSE for details.