https://github.com/coreason-ai/coreason-foundry

The Workspace Manager
https://github.com/coreason-ai/coreason-foundry

Last synced: 4 months ago
JSON representation

The Workspace Manager

• Host: GitHub
• URL: https://github.com/coreason-ai/coreason-foundry
• Owner: CoReason-AI
• License: other
• Created: 2026-01-10T15:25:39.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2026-01-18T15:51:27.000Z (5 months ago)
• Last Synced: 2026-01-18T16:34:24.632Z (5 months ago)
• Language: Python
• Size: 192 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Notice: NOTICE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# coreason-foundry

**The Collaborative Workspace Manager & Real-Time State Engine**

[![CI](https://github.com/CoReason-AI/coreason-foundry/actions/workflows/ci-cd.yml/badge.svg)](https://github.com/CoReason-AI/coreason-foundry/actions/workflows/ci-cd.yml)

[![Docker](https://github.com/CoReason-AI/coreason-foundry/actions/workflows/docker.yml/badge.svg)](https://github.com/CoReason-AI/coreason-foundry/actions/workflows/docker.yml)

[![PyPI - Version](https://img.shields.io/pypi/v/coreason_foundry.svg)](https://pypi.org/project/coreason_foundry)

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/coreason_foundry.svg)](https://pypi.org/project/coreason_foundry)

[![License](https://img.shields.io/badge/license-Prosperity--3.0-blue)](https://github.com/CoReason-AI/coreason-foundry/blob/main/LICENSE)

[![codecov](https://codecov.io/gh/CoReason-AI/coreason-foundry/graph/badge.svg)](https://codecov.io/gh/CoReason-AI/coreason-foundry)

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)

`coreason-foundry` is the interactive, stateful backend for the CoReason IDE. It bridges the gap between fleeting engineering thoughts and permanent GxP artifacts. It now includes a **Real-Time WebSocket Gateway** for presence tracking and event broadcasting.

## Documentation

Full documentation is available in the `docs/` directory and includes:

-   [**Product Requirements**](docs/product_requirements.md)

-   [**Architecture**](docs/architecture.md)

-   [**Usage Guide**](docs/usage.md)

-   [**Vignette**](docs/vignette.md)

-   [**Requirements**](requirements.md)

## Getting Started

### Prerequisites

- Python 3.12+

- Poetry

### Installation

1.  Clone the repository:

    ```sh

    git clone https://github.com/CoReason-AI/coreason-foundry.git

    cd coreason-foundry

    ```

2.  Install dependencies:

    ```sh

    poetry install

    ```

### Development

-   Run the linter:

    ```sh

    poetry run pre-commit run --all-files

    ```

-   Run the tests:

    ```sh

    poetry run pytest

    ```

-   Build the documentation:

    ```sh

    poetry run mkdocs build

    ```