# Friday

> Friday Studio is a desktop app for building AI workflows that run on your machine, on your schedule, with your data. Describe what you want in plain English, and Friday builds the agents, schedules, and connections. The result is a portable workspace.yml you can read, edit, and share. Start at /getting-started/quickstart or browse /core-concepts/agents.

## Docs

- [Friday Studio](https://docs.hellofriday.ai/index.md): Import and build powerful AI workflows that run on your machine, on your schedule, with your data.
- [Quick Start](https://docs.hellofriday.ai/getting-started/quickstart.md): Install Friday Studio and run your first AI workflow in under 5 minutes.
- [Spaces](https://docs.hellofriday.ai/getting-started/spaces.md): Create or import Spaces into Friday Studio and run your first AI workflow in under 5 minutes.
- [Communicators](https://docs.hellofriday.ai/getting-started/communicators.md): Connect a Communictor and chat with Friday on the go
- [Architecture](https://docs.hellofriday.ai/core-concepts/architecture.md): High-level overview of the components that make up Friday.
- [Agents](https://docs.hellofriday.ai/core-concepts/agents.md): Built-in and custom agents that execute operations in your agentic workflows.
- [Jobs](https://docs.hellofriday.ai/core-concepts/jobs.md): Jobs that orchestrate your agents step by step.
- [Signals](https://docs.hellofriday.ai/core-concepts/signals.md): Triggers that start jobs — HTTP webhooks, cron schedules, and filesystem events.
- [MCP Tools](https://docs.hellofriday.ai/core-concepts/mcp.md): Connect agents to external systems via Model Context Protocol servers.
- [Skills](https://docs.hellofriday.ai/core-concepts/skills.md): Reusable instruction sets loaded into agent context on demand. Package your standards, domain knowledge, and workflows into versioned Markdown files.
- [Memory](https://docs.hellofriday.ai/core-concepts/memory.md): Persistent state that accumulates across sessions and auto-injects into agent context.
- [Communicators](https://docs.hellofriday.ai/core-concepts/communicators.md): Connect Friday to chat platforms — Slack, Discord, Telegram, WhatsApp, Microsoft Teams.
- [Spaces](https://docs.hellofriday.ai/core-concepts/spaces.md): Top-level containers for your agents, jobs, and signals — driven by workspace.yml.
- [API](https://docs.hellofriday.ai/core-concepts/api.md): The Friday daemon — the local HTTP backend that powers spaces, agents, sessions, and signals.
- [Using Friday Studio](https://docs.hellofriday.ai/guides/friday-studio.md): Navigate the Studio UI — spaces, runs, jobs, skills, backup, and programmatic access.
- [Testing Agents](https://docs.hellofriday.ai/guides/agent-tester.md): Test any agent in isolation with different inputs, models, and configurations before wiring into workflows.
- [Inspecting Jobs](https://docs.hellofriday.ai/guides/job-inspector.md): Debug pipeline executions with DAG (Directed Acyclic Graph) visualization and waterfall timelines.
- [Slack](https://docs.hellofriday.ai/guides/communicators/slack.md): Connect a Slack app to a space for DMs and @mentions.
- [Discord](https://docs.hellofriday.ai/guides/communicators/discord.md): Connect a Discord bot to a space for DMs and @mentions.
- [Telegram](https://docs.hellofriday.ai/guides/communicators/telegram.md): Connect a Telegram bot to a space for direct messages.
- [WhatsApp](https://docs.hellofriday.ai/guides/communicators/whatsapp.md): Connect a WhatsApp Business number to a space for customer chat.
- [Microsoft Teams](https://docs.hellofriday.ai/guides/communicators/teams.md): Connect a Microsoft Teams bot to a space for DMs and @mentions.
- [Sharing Spaces](https://docs.hellofriday.ai/guides/sharing-spaces.md): Package a space for others — share the config, or hand off a full bundle with history and memory.
- [Call Friday from your app](https://docs.hellofriday.ai/guides/integrate-with-your-app.md): Trigger a workflow, stream its progress, and cancel it — all from your own application.
- [Agent SDK](https://docs.hellofriday.ai/sdk/overview.md): Build custom agents that integrate with Friday's runtime and tool ecosystem.
- [Overview](https://docs.hellofriday.ai/sdk/python.md): Write Friday agents in Python using the friday-agent-sdk package.
- [Quickstart](https://docs.hellofriday.ai/sdk/quickstart.md): Build a text analysis agent from an empty directory to a running result.
- [How agents work](https://docs.hellofriday.ai/sdk/how-agents-work.md): The subprocess model, host capabilities, and registration flow.
- [Generate text and objects](https://docs.hellofriday.ai/sdk/guides/call-llms.md): Route LLM calls through Friday's provider registry instead of importing API clients directly.
- [Fetch HTTP APIs](https://docs.hellofriday.ai/sdk/guides/make-http-requests.md): Make outbound HTTP requests through Friday's fetch layer - TLS, timeouts, and audit logging handled by Friday.
- [Call MCP tools](https://docs.hellofriday.ai/sdk/guides/use-mcp-tools.md): Configure MCP servers in your agent decorator and call tools via ctx.tools.
- [Extract structured data](https://docs.hellofriday.ai/sdk/guides/handle-structured-input.md): Extract JSON configurations from Friday's enriched prompts using parse_input() and parse_operation().
- [Emit progress events](https://docs.hellofriday.ai/sdk/guides/stream-progress.md): Emit progress events that appear in Friday's UI during long-running operations.
- [@agent Decorator](https://docs.hellofriday.ai/sdk/python-reference/agent-decorator.md): Registers a function as a Friday agent with metadata for discovery and execution.
- [AgentContext](https://docs.hellofriday.ai/sdk/python-reference/agent-context.md): Execution context passed to agent handlers, providing access to environment, capabilities, and metadata.
- [ctx.llm](https://docs.hellofriday.ai/sdk/python-reference/llm-capability.md): LLM capability wrapper for routing generation requests through Friday's provider registry.
- [ctx.http](https://docs.hellofriday.ai/sdk/python-reference/http-capability.md): HTTP capability wrapper for outbound requests through Friday's fetch layer.
- [ctx.tools](https://docs.hellofriday.ai/sdk/python-reference/tools-capability.md): MCP tool capability wrapper for invoking Model Context Protocol servers.
- [ctx.stream](https://docs.hellofriday.ai/sdk/python-reference/stream-capability.md): Stream capability wrapper for emitting progress events and intents to the Friday UI.
- [Result Types](https://docs.hellofriday.ai/sdk/python-reference/result-types.md): Tagged union results for agent handler returns.
- [Parse Utilities](https://docs.hellofriday.ai/sdk/python-reference/parse-utilities.md): Extract structured JSON from enriched prompts sent by Friday.
- [HTTP](https://docs.hellofriday.ai/reference/signals/http.md): Webhook signals for external services (GitHub, Bitbucket, Jira) and programmatic triggers.
- [Schedule](https://docs.hellofriday.ai/reference/signals/schedule.md): Cron-based signals that fire jobs on a timer.
- [Filesystem](https://docs.hellofriday.ai/reference/signals/fs-watch.md): Trigger jobs when files or directories change on disk.
- [Health check](https://docs.hellofriday.ai/api-reference/health/health-check.md): Check if the Friday daemon is running and get basic status information.
- [Get daemon status](https://docs.hellofriday.ai/api-reference/health/get-daemon-status.md): Get detailed daemon status including memory usage and active spaces.
- [List spaces](https://docs.hellofriday.ai/api-reference/spaces/list-spaces.md): List all registered spaces sorted by name.
- [Register a space](https://docs.hellofriday.ai/api-reference/spaces/register-a-space.md): Register a space by providing the path to a directory containing a `workspace.yml` file.
- [Create a space](https://docs.hellofriday.ai/api-reference/spaces/create-a-space.md): Create a new space from a configuration object. Creates the directory and files.
- [Get space details](https://docs.hellofriday.ai/api-reference/spaces/get-space-details.md): Get a space's details and configuration.
- [Delete a space](https://docs.hellofriday.ai/api-reference/spaces/delete-a-space.md): Delete a registered space.
- [Send a chat message](https://docs.hellofriday.ai/api-reference/chat/send-a-chat-message.md): Send a message to a space and receive a streaming response via Server-Sent Events.
- [Trigger a signal](https://docs.hellofriday.ai/api-reference/signals/trigger-a-signal.md): Manually trigger a signal in a space. Returns JSON by default, or an SSE stream if `Accept: text/event-stream` is set.
- [List sessions](https://docs.hellofriday.ai/api-reference/sessions/list-sessions.md): List all session summaries, optionally filtered by space.
- [Get session](https://docs.hellofriday.ai/api-reference/sessions/get-session.md): Get details of a specific session.
- [Cancel session](https://docs.hellofriday.ai/api-reference/sessions/cancel-session.md): Cancel a running session.
- [List agents](https://docs.hellofriday.ai/api-reference/agents/list-agents.md): List all available agents.
- [Get agent details](https://docs.hellofriday.ai/api-reference/agents/get-agent-details.md): Get detailed information about a specific agent.
- [List artifacts](https://docs.hellofriday.ai/api-reference/artifacts/list-artifacts.md): List artifacts with optional filtering by space or chat.
- [Get artifact](https://docs.hellofriday.ai/api-reference/artifacts/get-artifact.md): Get an artifact by ID with inline contents or database preview.
- [Delete artifact](https://docs.hellofriday.ai/api-reference/artifacts/delete-artifact.md): Soft-delete an artifact.
- [Upload file as artifact](https://docs.hellofriday.ai/api-reference/artifacts/upload-file-as-artifact.md): Upload a file and convert it to an artifact.
- [Get environment config](https://docs.hellofriday.ai/api-reference/configuration/get-environment-config.md): Get environment variables from the daemon's configuration.
- [Update environment config](https://docs.hellofriday.ai/api-reference/configuration/update-environment-config.md): Update environment variables in the daemon's configuration.
- [workspace.yml reference](https://docs.hellofriday.ai/reference/workspace-schema.md): Every field in workspace.yml, with a complete annotated example.
- [CLI](https://docs.hellofriday.ai/reference/cli.md): The friday command-line tool for managing spaces, agents, signals, and the Friday daemon.
- [Security](https://docs.hellofriday.ai/security.md): How Friday Studio handles your data, credentials, and vulnerabilities.

## OpenAPI Specs

- [openapi](https://docs.hellofriday.ai/api-reference/openapi.json)

## Optional

- [Join our community](https://discord.com/invite/uczJyp5FMH)
- [GitHub](https://github.com/friday-platform)