# Synthetic Sciences documentation

> OpenScience research guides, Ace, account workspaces, and private Graphs.

Full text: https://docs.syntheticsciences.ai/llms-full.txt

## OpenScience

### Start here

- [OpenScience](https://docs.syntheticsciences.ai/#/openscience/index): A workbench for literature, data, code, experiments, and scientific writing.
- [Quickstart](https://docs.syntheticsciences.ai/#/openscience/quickstart): Install OpenScience, choose model access, and complete your first research task.
- [What OpenScience can do](https://docs.syntheticsciences.ai/#/openscience/capabilities): Explore every major user workflow, its inputs, outputs, and setup.
- [Source and file types](https://docs.syntheticsciences.ai/#/openscience/source-types): Choose the right way to bring papers, tables, code, images, and scientific data into a project.
- [Installation and updates](https://docs.syntheticsciences.ai/#/openscience/installation): Install the desktop app or CLI, check your version, and keep your work when updating.

### Your workspace

- [Workspace](https://docs.syntheticsciences.ai/#/openscience/workspace): Find your projects, follow a conversation, and review the files OpenScience produces.
- [Projects and source folders](https://docs.syntheticsciences.ai/#/openscience/projects): Create a workspace, connect existing material, and keep related research organized.
- [Sessions and terminal runs](https://docs.syntheticsciences.ai/#/openscience/sessions): Start, continue, export, and import a research conversation.
- [Files and storage](https://docs.syntheticsciences.ai/#/openscience/files): Keep inputs, working files, and final results organized and recoverable.
- [Saved Results](https://docs.syntheticsciences.ai/#/openscience/results): Retain a completed output, download its exact file, and manage saved research results.

### Models and account

- [Account and workspaces](https://docs.syntheticsciences.ai/#/openscience/account): Complete sign-in, distinguish project folders from funding workspaces, and manage device access.
- [Models and providers](https://docs.syntheticsciences.ai/#/openscience/models): Choose Ace, connect your own provider access, and select a model for each task.
- [Ace and your account](https://docs.syntheticsciences.ai/#/openscience/ace): Set up managed access, choose a funding workspace, and manage your Wallet.
- [Ace model directory](https://docs.syntheticsciences.ai/#/openscience/ace-models): Browse the reviewed managed model identities and token limits shipped with this documentation version.
- [Pricing and usage](https://docs.syntheticsciences.ai/#/openscience/pricing): What the workbench costs, how Ace uses your Wallet, and how to control spending.
- [Usage reports and CSV exports](https://docs.syntheticsciences.ai/#/openscience/usage): Filter activity by source, model, and date, and distinguish Wallet charges from local estimates.
- [Local models](https://docs.syntheticsciences.ai/#/openscience/local-models): Connect Ollama, LM Studio, or an endpoint on infrastructure you manage.
- [Custom providers](https://docs.syntheticsciences.ai/#/openscience/custom-providers): Connect a compatible model service that is not in the provider picker.

### Plan and continue

- [Research controls](https://docs.syntheticsciences.ai/#/openscience/agents): Plan a task, choose research effort, and decide when OpenScience should ask you.
- [Planning and persistent goals](https://docs.syntheticsciences.ai/#/openscience/planning): Turn a broad research objective into a plan, bounded experiments, and reviewable progress.
- [Context, checkpoints, and handoffs](https://docs.syntheticsciences.ai/#/openscience/context): Keep long investigations understandable and recoverable as a conversation grows.
- [Share and hand off research](https://docs.syntheticsciences.ai/#/openscience/team-workflows): Package files, instructions, and results so another person can continue the work.

### Personalize and get help

- [Appearance, notifications, and updates](https://docs.syntheticsciences.ai/#/openscience/preferences): Set up the workspace for how you read, monitor work, and keep the app current.
- [Privacy and data](https://docs.syntheticsciences.ai/#/openscience/privacy): Understand local storage, model and tool requests, session trace sharing, and deletion controls.
- [Keyboard shortcuts](https://docs.syntheticsciences.ai/#/openscience/keyboard-shortcuts): Navigate projects, compose requests, and reach workspace actions from the keyboard.
- [Troubleshooting](https://docs.syntheticsciences.ai/#/openscience/troubleshooting): Resolve installation, model access, account, file, and research-tool problems.
- [Frequently asked questions](https://docs.syntheticsciences.ai/#/openscience/faq): Short answers about accounts, pricing, local models, projects, and research results.

### Research and evidence

- [Workflow cookbook](https://docs.syntheticsciences.ai/#/openscience/workflow-examples): Start with a complete request and know what a useful result should contain.
- [Literature reviews](https://docs.syntheticsciences.ai/#/openscience/literature-review): Search with a clear scope, compare evidence, and save a review you can check.
- [Research search](https://docs.syntheticsciences.ai/#/openscience/research-search): Find web and scholarly material, apply source filters, and inspect what a search actually returned.
- [Searching scientific databases](https://docs.syntheticsciences.ai/#/openscience/database-workflows): Discover a database, query its records, fetch supported files, and retain source identifiers.
- [Reading and extracting documents](https://docs.syntheticsciences.ai/#/openscience/documents): Work through papers, protocols, PDFs, and reports with checkable source references.

### Analyze and experiment

- [Data analysis](https://docs.syntheticsciences.ai/#/openscience/data-analysis): Inspect inputs, agree on an analysis, and save code and results together.
- [Code, repositories, and the terminal](https://docs.syntheticsciences.ai/#/openscience/code): Explore research code, make reviewable changes, and run project commands.
- [Statistical analysis](https://docs.syntheticsciences.ai/#/openscience/statistics): Build a transparent analysis from the study design through uncertainty and sensitivity checks.
- [Python and R analysis](https://docs.syntheticsciences.ai/#/openscience/python-r): Run calculations, retain working variables, inspect plots, and turn an interactive analysis into reusable code.
- [Machine learning experiments](https://docs.syntheticsciences.ai/#/openscience/machine-learning): Build baselines, compare models, and preserve an evaluation that can be repeated.
- [Genomics and sequence analysis](https://docs.syntheticsciences.ai/#/openscience/genomics): Work from reference records through read, variant, annotation, and single-cell inspection.
- [Molecular and structural research](https://docs.syntheticsciences.ai/#/openscience/molecular-research): Inspect molecules and structures, calculate properties, and prepare supported scientific workflows.
- [Reproduce a result](https://docs.syntheticsciences.ai/#/openscience/reproduction): Turn a paper or repository into a bounded experiment with explicit success criteria.
- [Experiment plans and evidence](https://docs.syntheticsciences.ai/#/openscience/experiment-tracking): Keep the objective, planned checks, trial outcomes, and lessons tied to concrete research outputs.

### Communicate results

- [Scientific figures and visualization](https://docs.syntheticsciences.ai/#/openscience/figures): Turn data into clear plots with inspectable code, captions, and export checks.
- [Figures and writing](https://docs.syntheticsciences.ai/#/openscience/writing): Turn checked analysis into figures, methods, and research documents.
- [Generate and edit images](https://docs.syntheticsciences.ai/#/openscience/image-generation): Create illustrations and revise existing images while keeping the outputs in your project.

### Run substantial work

- [Compute](https://docs.syntheticsciences.ai/#/openscience/compute): Prepare analysis tools and connect your own resources for larger experiments.
- [Compute jobs and output recovery](https://docs.syntheticsciences.ai/#/openscience/jobs): Plan a run, launch it on an available target, follow status, and retrieve its outputs.
- [Remote compute and GPU accounts](https://docs.syntheticsciences.ai/#/openscience/remote-compute): Connect your own Modal account or SSH host and understand other compute-account connections.
- [Autoresearch](https://docs.syntheticsciences.ai/#/openscience/autoresearch): Let a study hill-climb a metric over many runs while you watch: tracked metrics, a baseline, ideas ranked by expected value, and a ledger of what was kept.

### Find a tool

- [Explore tools](https://docs.syntheticsciences.ai/#/openscience/explore-tools): Browse research tools, scientific software, databases, and connected services, with setup and usage guides.
- [Built-in research tools](https://docs.syntheticsciences.ai/#/openscience/built-in-tools): See the operations available to the agent and learn how to request useful, checkable work.
- [Scientific tool catalog](https://docs.syntheticsciences.ai/#/openscience/tool-catalog): Every scientific catalog entry, with a purpose, documentation link, and setup or availability details.
- [Scientific tools](https://docs.syntheticsciences.ai/#/openscience/scientific-tools): Check which analysis tools can run and what setup they need.

### Data and viewers

- [Scientific databases](https://docs.syntheticsciences.ai/#/openscience/databases): Find the scientific records and literature sources available to the agent.
- [Tables and datasets](https://docs.syntheticsciences.ai/#/openscience/tables): Inspect columns, filter and sort rows, explore distributions, and export a useful subset.
- [Scientific viewers](https://docs.syntheticsciences.ai/#/openscience/scientific-viewers): Explore structures, sequences, genomic files, and scientific datasets in the workspace.

### Connect and extend

- [Connectors and MCP](https://docs.syntheticsciences.ai/#/openscience/connectors): Add external tools and services to your research workflow.
- [Service credentials](https://docs.syntheticsciences.ai/#/openscience/service-credentials): Connect your own research services and distinguish saved access from a working integration.
- [Create a custom tool](https://docs.syntheticsciences.ai/#/openscience/custom-tools): Add a small typed operation that the agent can call from a project.

### Use skills

- [Skills](https://docs.syntheticsciences.ai/#/openscience/skills): Use reusable research procedures and add your own.
- [Skill directory](https://docs.syntheticsciences.ai/#/openscience/skill-library): Browse the research procedures included with this documentation version.
- [Skill recipes](https://docs.syntheticsciences.ai/#/openscience/skill-workflows): Choose a reusable procedure, provide the right input, and ask for a concrete deliverable.

### Project setup

- [Project instructions](https://docs.syntheticsciences.ai/#/openscience/instructions): Teach OpenScience the conventions, methods, and limits of a project.
- [Configuration](https://docs.syntheticsciences.ai/#/openscience/configuration): Save repeatable model, instruction, skill, and tool settings.
- [Slash commands](https://docs.syntheticsciences.ai/#/openscience/slash-commands): Use conversation controls and define reusable project requests.
- [Permissions and control](https://docs.syntheticsciences.ai/#/openscience/permissions): Choose when the agent asks and review consequential actions before they happen.

### CLI and integrations

- [CLI reference](https://docs.syntheticsciences.ai/#/openscience/commands): Commands for setup, research, models, accounts, sessions, and extensions.
- [Automation and JSON output](https://docs.syntheticsciences.ai/#/openscience/automation): Run repeatable terminal tasks and consume their results programmatically.
- [Runtime SDK and API](https://docs.syntheticsciences.ai/#/openscience/api): Build a scientific assistant against the same runtime used by the OpenScience workbench.
- [Headless server hosting](https://docs.syntheticsciences.ai/#/openscience/server-hosting): Connect to, own, and build an OpenScience runtime without the browser workbench.
- [Plugins, SDK, and editors](https://docs.syntheticsciences.ai/#/openscience/extensions): Extend OpenScience or connect it to your own application.

## Synthetic Sciences

### Get started

- [Synthetic Sciences account](https://docs.syntheticsciences.ai/#/account/index): Manage OpenScience access, Ace, workspaces, private Graphs, and Ascent from your dashboard.
- [Account setup](https://docs.syntheticsciences.ai/#/account/quickstart): Sign in, choose a workspace, connect OpenScience, and verify the first request.
- [Authentication and devices](https://docs.syntheticsciences.ai/#/account/authentication): Understand browser sign-in, workspace-bound keys, device approval, and sign-out.

### Workspaces and access

- [Workspaces and members](https://docs.syntheticsciences.ai/#/account/workspaces): Choose Personal or team funding, invite members, and manage access and spending permissions.
- [Workspace API keys](https://docs.syntheticsciences.ai/#/account/api-keys): Create, use, and revoke keys that connect OpenScience to a specific workspace.
- [Shared connections](https://docs.syntheticsciences.ai/#/account/shared-connections): Let authorized members use workspace provider and service connections without confusing them with personal keys.

### Ace and your account

- [Wallet and billing](https://docs.syntheticsciences.ai/#/account/billing): Fund Ace, distinguish purchased and promotional credit, and control optional automatic charges.
- [Usage reports](https://docs.syntheticsciences.ai/#/account/usage): Inspect account and workspace activity, filter UTC dates and models, and export matching totals.
- [Account privacy and data](https://docs.syntheticsciences.ai/#/account/privacy): Understand trace sharing, private research, usage visibility, and deletion boundaries.
- [Ascent access](https://docs.syntheticsciences.ai/#/account/ascent): Request access, check your account's status, and download an approved build when available.

### Private research

- [Private Graphs](https://docs.syntheticsciences.ai/#/account/graphs): Keep research claims, hypotheses, results, and decisions connected to their evidence.
- [Evidence and portability](https://docs.syntheticsciences.ai/#/account/evidence): Attach research evidence, preserve provenance, and export records without assuming every file is included.
- [Graph sharing](https://docs.syntheticsciences.ai/#/account/sharing): Understand private ownership, explicit collaborator permissions, and the limits of workspace membership.

### Reference and help

- [API boundaries](https://docs.syntheticsciences.ai/#/account/api): Choose the OpenScience local API or the account service without relying on retired Atlas contracts.
- [Atlas compatibility and migration](https://docs.syntheticsciences.ai/#/account/compatibility): Find current workflows when an older Atlas page, command, package, or bookmark no longer applies.
- [Account troubleshooting](https://docs.syntheticsciences.ai/#/account/troubleshooting): Resolve sign-in, membership, funding, usage, and Ascent access problems.