> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hellofriday.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Spaces
> Create or import Spaces into Friday Studio and run your first AI workflow in under 5 minutes.
Spaces are where you get work done in Friday — each one is a collection of agents, jobs, and signals focused on a specific task.
## Create your own
Go to **Chat** and describe what you want:
> "I want a space that monitors my GitHub notifications every morning and sends me a digest of open PRs and reviews waiting on me."
Friday creates the space, wires up the agents and schedule, and registers it all through conversation. You can keep refining it by chatting.
As you define your space in chat, Friday will ask clarifying questions and request login details where appropriate.
Friday authorizes with external services via OAuth or API Keys. Authorization
can be revoked at any time.
## Import an existing Space
Friday comes with starter spaces you can import from the library. Using the **Inbox Zero**, which triages your Gmail and learns your preferences over time:
In the Studio sidebar, click **Discover Spaces**. You'll see the full
space library.
Find **Inbox Zero** and click **Add Space**. Friday imports it and takes you
to its dashboard.
The space README tells you what to set up. For Inbox Zero: click
**Connect** on the Gmail integration. Sign in with Google and approve
access.
Each space has a short README with any setup specific to that workflow —
usually just connecting an account or filling in your email address. Read
it, follow the steps.
### Upload your own
You can upload a Space's .zip bundle by clicking the "Plus" icon next to "Spaces" in the Friday Studio sidebar, or by clicking **Settings** in the sidebar and navigating to "Import a space" under "Backup & restore"
## Run your Space
Spaces use Signals to trigger Agents and Jobs. If you requested your Space to run on a regular schedule, the signal will run on a regular interval via CRON. You can also manually run a Signal at any time via chat. Let's use the Inbox Zero example from the "Import an existing Space" above:
Go to the **Chat** tab in your Inbox Zero space and say:
> "Review my inbox"
Friday fetches your 10 most recent unread emails and walks you through them one at a time. For each one, you choose what to do — archive, keep, delete, or unsubscribe. Friday acts on your choice immediately.
After the first session, it starts remembering your patterns. Run it again and it surfaces suggested actions based on what you've done before. Enable the autopilot job and it runs every morning at 8am, handles the high-confidence calls itself, and flags anything it's unsure about.
Every Space in the library works this way — import, connect, run. The README
tells you exactly what each one needs.
## Review configuration
Every Space can be viewed as a single `workspace.yml` file where you can read, edit, and update its version. Whether created via chat or imported, the underlying config looks like this:
```yaml workspace.yml theme={null}
version: "1.0"
workspace:
name: My Workflow
description: What this space does
signals:
run-now:
provider: http
title: Run now
description: Trigger manually
config:
path: /run-now
agents:
my-agent:
type: atlas
agent: web
description: Does the thing
prompt: |
Describe exactly what you want the agent to do.
jobs:
my-job:
title: My Job
description: What this job does
triggers:
- signal: run-now
fsm:
initial: idle
states:
idle:
on:
run-now:
target: run
run:
entry:
- type: agent
agentId: my-agent
- type: emit
event: DONE
on:
DONE:
target: done
done:
type: final
```
Space configs are accessible by going to **Overview** under you Space in the Friday Studio sidebar and clicking "Edit Configuration" in the top right corner of the screen
## What’s next
9 ready-made spaces covering email, GitHub, Telegram, Google Sheets, price
monitoring, and more.
Connect a Communictor and chat with your Space on the go.