Skip to content

Artifact-Virtual/CREWos

Repository files navigation

CrewOS v2.5

Python Streamlit Docker GitHub Pytest YAML OpenAI SERPER CLI UI WebSocket

CrewOS is an autonomous AI engineering runtime designed to orchestrate multi-agent collaboration, embedding memory, and multimodal capabilities. It provides a streamlined pipeline for planning, coding, reviewing, and refining AI projects.

Features

  • Modular agent orchestration
  • Plan → Code → Review → Refine loop
  • WebSocket-based real-time logs
  • CLI and UI integration
  • Embedding memory and feedback system
  • Multi-crew collaboration for subprojects

Requirements

  • Python: 3.10+
  • Dependencies: Listed in setup.py

Installation

  1. Clone the repository:
git clone <repository-url>
cd crewos
  1. Install the package:
pip install -e .
  1. Set up environment variables: Create a .env file in the root directory with the following:
OPENAI_API_KEY=your_openai_api_key
SERPER_API_KEY=your_serper_api_key
GH_TOKEN=your_github_token

Usage

CLI Commands

  • Initialize a project with a template:

    crewos init chatbot
  • Run the pipeline:

    crewos run
  • Check the status of recent tasks:

    crewos status

Launch the UI

Run the following command to start the Streamlit-based UI:

streamlit run src/engineering/ui/app.py

The UI provides real-time logs, memory traces, and task management.

Project Structure

.
│   .env
│   .gitignore
│   pyproject.toml
│   README.md
│
├── knowledge/
│   └── user_preference.txt
│
├── src/
│   └── engineering/
│       │   crew.py
│       │   main.py
│       │   __init__.py
│       │
│       ├── config/
│       │   └── agents.yaml
│       │   └── tasks.yaml
│       │
│       └── tools/
│           ├── custom_tool.py
│           └── __init__.py
│
└── tests/
   └── test_pipeline.py

Development

Testing

Run the unit tests using pytest:

pytest tests/

Docker

Build and run the Docker container:

docker build -t crewos .
docker run -p 8501:8501 crewos

Contributing

Contributions are welcome! Please fork the repository and submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

About

CrewOS is an autonomous AI engineering runtime designed to orchestrate multi-agent collaboration, embedding memory, and multimodal capabilities.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors