Getting Started

Getting Started

This page covers first install, first launch, and the fastest path to a productive Gridoryn setup.

Requirements

• Python 3.11 or newer
• pip
• A local virtual environment is recommended

Install

macOS / Linux

git clone https://github.com/cosmowyn/Gridoryn.git Gridoryn
cd Gridoryn
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

Windows PowerShell

git clone https://github.com/cosmowyn/Gridoryn.git Gridoryn
cd Gridoryn
py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install --upgrade pip
pip install -r requirements.txt

Run

python main.py

First Launch Options

On first launch, Gridoryn can guide you into one of several entry paths:

• Start with an empty workspace
• Load the full showcase demo into the current empty workspace
• Open a separate demo workspace
• Open the embedded guide
• Jump directly into the review workflow

Recommended First 15 Minutes

1. Open the demo workspace if you want to see the full feature surface immediately.
2. Explore the main task tree and details panel.
3. Open the Project cockpit for one top-level project.
4. Open the Review workflow and Focus mode once so the panel model makes sense.
5. Open Workspace profiles to understand where your data lives.

Understanding the Main Layout

Gridoryn is organized around a few primary surfaces:

• Task tree: the main planning and editing workspace
• Details panel: deeper task metadata and notes
• Filters and perspectives: quick context switching
• Project cockpit: structured project planning and timeline work
• Supporting docks: review, focus, relationships, calendar, analytics, undo history

Using the Demo Workspace

The built-in demo is intentionally dense. It is not a toy sample.

It includes:

• Four populated projects
• Timeline planning examples
• Milestones and deliverables
• Risk, issue, assumption, and decision registers
• Recurrence, reminders, attachments, templates, and archive data
• Saved views and realistic workload pressure

Use it when you want to learn the product shape before importing or creating your own work.

If You Prefer an Empty Start

Start with a clean workspace if:

• You already have a planning system in mind
• You want to learn only one feature at a time
• You do not want demo content mixed into your database

In that case, read Daily Workflow next.