Investment Intelligence Platform

Argus is a full-stack investment intelligence platform under active development. It is designed to centralize portfolio management, broker connections, market data, risk analysis, and AI-assisted investment research in one secure system.

Status: Active development
Current version: 0.2.0
Repository visibility: Private while core development continues

Product vision

Argus is being built to help investors and financial teams replace fragmented tools and manual analysis with a structured platform for:

• Portfolio management
• Broker account connections
• Market intelligence
• Risk monitoring
• Performance analytics
• AI-assisted research
• Secure user access
• Financial workflow automation

Current capabilities

• User registration and authentication
• Access and refresh token schemas
• Portfolio creation and management foundations
• Broker account connection records
• Market service foundation
• PostgreSQL persistence
• Docker-based local environment
• FastAPI REST API
• Interactive Swagger documentation
• Automated backend tests

Architecture

Client applications
        |
        v
FastAPI REST API
        |
        +-- Authentication
        +-- Users
        +-- Portfolios
        +-- Broker accounts
        +-- Markets
        +-- System services
        |
        v
PostgreSQL

The platform follows a modular backend architecture with separate API, service, schema, model, database, and agent layers.

Technology stack

Backend

• Python
• FastAPI
• SQLAlchemy
• Pydantic
• Uvicorn

Data

• PostgreSQL

Infrastructure

• Docker
• Docker Compose
• Linux

Quality

• Pytest
• Typed schemas
• Modular API routing

Project structure

argus/
├── backend/
│   ├── app/
│   │   ├── agents/
│   │   ├── api/
│   │   ├── core/
│   │   ├── database/
│   │   ├── models/
│   │   ├── routes/
│   │   ├── schemas/
│   │   └── services/
│   └── tests/
├── scripts/
├── AGENTS.md
├── CHANGELOG.md
├── docker-compose.yml
└── README.md

Run locally

./scripts/dev.sh

Local endpoints

• API: http://localhost:8000
• Swagger: http://localhost:8000/docs
• Health: http://localhost:8000/api/v1/health

Initial API flow

1. Register a user with POST /api/v1/auth/register.
2. Authenticate with POST /api/v1/auth/login.
3. Copy the returned access token.
4. Select Authorize in Swagger.
5. Create a portfolio.
6. Register a broker account connection.

Development roadmap

Completed

• Core backend architecture
• Database foundation
• Authentication foundation
• User module
• Portfolio module
• Broker account module
• System health endpoints
• Docker development environment

In progress

• Frontend dashboard
• Expanded portfolio analytics
• Market data services
• Broker integration architecture
• AI investment agent

Planned

• Real broker API integrations
• Risk engine
• Portfolio performance reports
• Alerts and notifications
• Mobile experience
• Production deployment

Important note

Broker connections currently store account connection records only. Live brokerage API integrations and trading capabilities are not enabled in this version.

Ownership

Argus is an independently developed private software product. All rights reserved.