Skip to main content

Multi-Agent Autonomous Coding System for Terminal

Project description

Stratos

Stratos is a multi-agent autonomous coding system designed for the terminal. It orchestrates specialized AI agents to generate, modify, and execute code based on high-level specifications. By leveraging Google Gemini, Stratos bridges the gap between natural language requirements and functional software prototypes.

System Overview

The system operates as a command-line utility that spawns specialized AI agents. These agents work within a controlled sandbox to perform software engineering tasks, including:

  • Requirement Analysis: Transforming brief user requests into detailed technical specifications.
  • Code Generation: Writing functional Python code efficiently.
  • Execution & Validation: Running code within a safety wrapper and analyzing outputs.
  • Iterative Refinement: Self-correcting based on execution logs and error streams.

Core Capabilities

Autonomous Agent Team

Stratos employs a multi-agent architecture (Manager, Architect, Coder, Reviewer) where distinct roles handle specific aspects of the development lifecycle.

Security Sandbox

To mitigate the risks associated with executing AI-generated code, Stratos implements a strict sandbox layer. This layer intercepts system calls and validates commands against a safety policy.

Premium Terminal Dashboard

The interface is built for high-density information display, providing real-time visibility into the agent's thought process, the active task queue, and the raw execution logs.

Installation

Prerequisites

  • Python 3.10 or higher
  • A Google Gemini API key

Setup Steps

  1. Clone the repository

    git clone https://github.com/SPTApyo/stratos.git
    cd stratos
    
  2. Run the Global Installer Stratos includes a professional installer to set up the system globally or locally.

    chmod +x install.sh
    ./install.sh
    

Configuration

Stratos requires a Google Gemini API key. Upon first launch, the system will prompt you to enter your key securely. It will be saved in a local .env file.

Usage

Once installed, you can launch Stratos from anywhere:

stratos

Command Line Options

  • -p NAME: Directly launch a specific project.
  • -d TEXT: Provide project description via CLI.
  • --quick: Quick launch MVP mode (shortcut for -p *).
  • --theme NAME: Override UI theme.
  • --debug: Enable technical tracing.

Disclaimer

Experimental Software: Stratos is an autonomous assistant that executes code on your local machine. Use with caution. The authors are not responsible for any data loss or system instability.

License

This software is distributed under the MIT License.

Copyright (c) 2026 SPTApyo

Project details


Release history Release notifications | RSS feed

This version

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stratos_core-0.1.tar.gz (34.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

stratos_core-0.1-py3-none-any.whl (39.1 kB view details)

Uploaded Python 3

File details

Details for the file stratos_core-0.1.tar.gz.

File metadata

  • Download URL: stratos_core-0.1.tar.gz
  • Upload date:
  • Size: 34.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for stratos_core-0.1.tar.gz
Algorithm Hash digest
SHA256 896db86f1a67a8c97f761291e5ff503f076a8adf106bfc53b5f4a24019d6c3c3
MD5 06d9901127b6ef8348cb8c7633d1ad66
BLAKE2b-256 d1ae3bb521c3f5210af3426330cb226eac5b0023228364ed56f94513b28312da

See more details on using hashes here.

Provenance

The following attestation bundles were made for stratos_core-0.1.tar.gz:

Publisher: release.yml on SPTApyo/stratos-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file stratos_core-0.1-py3-none-any.whl.

File metadata

  • Download URL: stratos_core-0.1-py3-none-any.whl
  • Upload date:
  • Size: 39.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for stratos_core-0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 aab9d266b57ae563ff6cc97bcf820f30f758d447a6301b499cf6545f1eddf9c7
MD5 c65565fad5446a91a7a217ab5a79e678
BLAKE2b-256 146622455b1de3a1a9fd4a7c9c4fba50c639f3a748b6cd334137e5a61901d05f

See more details on using hashes here.

Provenance

The following attestation bundles were made for stratos_core-0.1-py3-none-any.whl:

Publisher: release.yml on SPTApyo/stratos-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page