Skip to content
Projects

aipoch/open-science has 5,493 GitHub stars and 552 forks. GitHot measured +8 stars in 24 hours. Last checked 2026-11-08 12:38 UTC. Last push 2026-11-02.

How these counts are measured

The open-source AI research workbench for scientific research and agent workflows. Local-first, model-agnostic desktop app with extensible skills, MCP tools and connectors, Python/R execution and traceable artifacts for reproducible research on macOS, Windows and Linux.

What you can do

  • Connectors - Access scientific resources through 48 built-in connectors, or add custom local and remote MCP connectors. Some built-in sources are disabled by default and require per-source opt-in. Manage tool-level permissions and import or export connector configurations.
  • Specialists and delegation - Install 10 Specialists from the Specialist Marketplace, or create and customize personal specialists for delegation from the main agent. Specialist packages support import and export; marketplace contributions are reviewed before publication, and local imports do not publish them.
  • Models and agent backends - Use cloud models, compatible custom gateways, or Claude and Codex subscription logins. Choose from five agent backends — Claude Code, OpenCode, Codex, CodeBuddy, and Pi — with model connection checks, image input, and reasoning controls.
  • Python, R, notebooks, and HPC - Run Python, R, Notebook, and shell workloads locally using managed environments or your own interpreters, with background execution and recorded history. Connect to remote hosts through SSH or submit work through Slurm; remote workloads require the host, software, resources, and permissions described in the remote-compute FAQ.

Measured star growth

in 24h
+8
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

AIPOCH Open-Science

AI research workbench for reproducible science — open-source, local-first, and model-agnostic.

Download AIPOCH Open-Science Latest AIPOCH Open-Science version AIPOCH Open-Science Zenodo DOI AIPOCH Open-Science preprint on arXiv: 2610.17110 AIPOCH Open-Science — Benchmark results Platforms macOS Windows Linux License Apache 2.0 Website aipoch.com

README in English 简体中文 README 繁體中文 README 日本語 README 한국어 README Français README README на русском German README Español README

AIPOCH Open-Science is an open-source AI research workbench. Start with a question, a paper, or a data file. Describe what you want to find out in your own words, and work with an AI agent to explore the evidence, analyze data, or create a chart.

When you want to see how a result was produced, inspect the available inputs, code, and execution history. To share the work, export a .science package with the conversation branches, file versions, Notebook records, and verification evidence you choose.

💡 AIPOCH Open-Science v1.1.0 updates

November 5, 2026

  • Research films: Export any session as a portable, narrated research film with terminal playback and voice narration.
  • Mobile pairing: Connect a phone or tablet by scanning a QR code, over local WiFi or a Pinggy tunnel.
  • Literature in CLI and MCP: Search and manage references from the command line and MCP clients, with read-only browsing plus write tools.
  • Resumable overviews: Batch paper overviews resume after interruptions without regenerating completed results.
  • Resource center: A renamed resource center with an adapted case library layout, more compact external links, and compute settings under connections.
  • Diagnostics: Exports preserve Notebook execution evidence, allow selecting historical backend logs, and can include opt-in resource recordings (Windows).
  • Reliability fixes: Recover conversations after interruptions, restore PDF figures and tables from searchable scans, and improve startup, Windows update checks, and memory use.

View the full v1.1.0 release notes

View the full v1.0.8 release notes

AIPOCH Open-Science banner: Science, Open to All — an open-source, model-agnostic, self-hosted scientific AI research workbench

Table of Contents

🚀 Quick Start

1. Download the app

Open the official download page and choose the installer for your computer:

Your computer Choose
macOS 12+ — Apple Silicon (M1 or newer) The macOS DMG for Apple Silicon / ARM64
macOS 12+ — Intel The macOS DMG for Intel / x64
Windows 10/11 x64 The Windows x64 installer (code-signed)
Linux x64 The Linux x64 AppImage or Debian package
Linux ARM64 The Linux ARM64 AppImage or Debian package

See download verification for checks before installation.

On macOS, you can also install with Homebrew:

brew install --cask open-science

The release assets include standalone CLI archives for macOS, Linux, and Windows. They bundle Node.js, so you can run the CLI without installing Node.js, npm, or Homebrew.

For the standalone CLI on macOS or Linux, use the separate AIPOCH tap:

brew install aipoch/tap/open-science

This Formula includes Node and runs without the desktop app; its release may differ from the desktop Cask. See the standalone runtime guide for prerequisites and upgrades.

For the standalone CLI and Web UI, install the published npm package with Node.js 22.13.0 or later:

npm install --global @aipoch/open-science
open-science start --no-open
open-science url

Open the printed URL to complete setup, or follow the terminal setup guide. npm supports macOS ARM64/x64, glibc Linux ARM64/x64 and Windows x64; the desktop app is not required. Keep npm optional dependencies enabled and review the Linux prerequisites and upgrade instructions. The URL contains an authentication token; keep it private.

Windows reinstalls preserve research data. For a full cleanup, see the data reset tool, which permanently deletes local data after confirmation.

2. Complete first-time setup

Follow the setup wizard: Environment → Data location → Agent runtime → Model provider → Notebook runtime.

Complete the required environment and agent-runtime checks and test your model connection. Python/R Notebook setup is optional; Notebook and data-location settings can be changed later.

After setup, open System settings to change appearance or notifications. In General, you can find diagnostics, command-line tools, and the guide to manual installation and updates.

Automatic first-run environment checks in AIPOCH Open-Science First-run model provider configuration in AIPOCH Open-Science
Host compatibility, storage, and network checks Provider, API Key, endpoint, and model validation

3. Start a research project

  1. Click New project, open a session, and describe your research goal, inputs, and expected outputs.
  2. Attach files, select a model and approval mode, then send the task. Use @ to reference project files or / to choose a skill.
  3. Review tool activity and any approval requests, preview the results, and check their available evidence in Provenance.

Screenshots in this README illustrate the workflow. Labels, catalogs, and other interface details may differ from the version you install.

AIPOCH Open-Science .science Research Packages

Export a completed research session as a portable .science package for review, handoff, and archiving. Choose the conversation branches, file versions, Notebook records, and verification evidence to include, then import the package into another project or computer.

Export and import are available in the desktop app, local Web sessions, and the headless CLI. Remote Web sessions cannot read or write arbitrary local package paths.

Export → transfer → inspect

  1. Export a completed session and choose the contents to include.
  2. Move the .science file to a collaborator or another computer.
  3. Import it into a project. The right-hand Research replay shows the recorded process; the left-hand conversation lets you ask about it and follow fixed step references.

Imported records remain read-only. Watching a replay does not execute code, call a model, or restore credentials. Your first question creates an associated writable discussion. Choose Fork to continue to create a writable copy for follow-up work. Re-executing a result still requires a complete recipe, required inputs, and an available runtime.

Side Chat conversations, private reading bookmarks, and credentials are excluded; included files depend on export selection. Received verification records describe the sender’s checks, not a rerun on this computer. See the .science package guide.

AIPOCH Open-Science Paper and Citation

AIPOCH Open-Science: An Open-Source AI Research Workbench with Reproducible .science Packages

arXiv preprint · v1 · Submitted October 12, 2026.

Our preprint introduces AIPOCH Open-Science, an open-source AI research workbench with portable .science packages for sharing research context, artifact versions, and verification records. Read the paper for the package exchange design and controlled evaluation.

If you use AIPOCH Open-Science in your research, you can cite the preprint:

BibTeX citation
@misc{ouyang2026aipochopenscienceopensourceai,
      title={AIPOCH Open-Science: An Open-Source AI Research Workbench with Reproducible .science Packages},
      author={Wen Ouyang and Bocheng Huang and Qianyu Yao and Fei Sun and Minying Deng and Haoyue Cheng and Wenwen Zhou and Lei Mou and Yusi Wei and Jiang Li and Kun Zhu and Lei Wang and Yi Feng and Jiaheng Dai and Ke Qian and Dan Wang and Yahui Wang and Chenyi Wang and Mingsheng Lyu and Yaqiang Zhang and Ping Zheng and Chunhua Tang and Xinge Ma and Xu Zhang and Youjia Fan and Can Lu and Zhijun Dai and Man Hu and Qiqi Xie and Beinan Liu and Yuanning Guo and Yunze Liu and Jinhong Jiang and Xianjun Fu and Mingwei Zhang and Yuanji Xu and Shilin Xia and Bowen Yang and Mingjun Yu and Jingdun Xie and Xuwei Chen and Xia Zou and Yuzhou Xue and Jianguo Zhou and Chunhao Cao and Donghao Tian and Lei Huang and Jinxiao Li and Shengrong Long and Zefeng Song and Honglin Li and Jiang Luo and Wenying Jiang and Shanshan Li and Lei Dai and Ning Jiang and Ying Cai and Chaohui Li and Chunyan Peng and Hetong Zhao and Angqing Li and Chunyan Yang and Chongyang Sun and Yong Li and Xinyu Shi and Wei Dai and Ming Peng and Chen Sang and Yuanyuan Han and Desong Qiu and Haixin Miao and Jian Xu and Yi Chen and Xiaoliang Shi and Tian Shen and Teng Hu and Shuhao Wang and Yingyong Hou and Huimei Wang},
      year={2026},
      eprint={2610.17110},
      archivePrefix={arXiv},
      primaryClass={cs.SE},
      url={https://arxiv.org/abs/2610.17110},
}

Benchmark Results

AIPOCH evaluated AIPOCH Open-Science on tasks ranging from finding a paper to answering questions about its contents and carrying out a research plan. The results below come from AIPOCH's own runs. Each score describes a particular task and evaluation setup.

Task What AIPOCH Open-Science achieved
Find the target paper For 68 of 75 test questions, the target paper appeared in the first 30 results on LitQA2-FullText-Search (90.67% Recall@30, gpt-6-astra).
Answer questions using the literature In a separate run on LitQA2-FullText, Open-Science answered 70 of 75 test questions correctly (93.33% accuracy, deepseek-flash with Max reasoning).
Synthesize a cited answer On 100 ScholarQA-CS2 validation questions, Open-Science earned a composite quality score of 0.9289/1 using deepseek-v4-flash. Official test references use different questions.
Carry out research workflows In local ASI-Bench runs using the same model, Open-Science scored 59.46 on B4 and Codex scored 55.45. On B2 the scores were nearly identical (56.11 and 56.09).
Analyze biomedical data On BiomniBench-DA Public 50, two judges scored the outputs 81.04 and 77.06. Their equal-weight mean was 79.05.

AstaBench — Literature tasks

Paper retrieval — target paper found for 68 of 75 questions

AIPOCH ran the official 75-question LitQA2-FullText-Search Test split locally. Its result matched the highest Recall@30 in the October 26, 2026 comparison snapshot. This local run was not an official leaderboard submission or placement.

AIPOCH Open-Science LitQA2 retrieval comparison: 90.67% local Recall@30 on the official Test split

Recall@30 counts a hit when the target paper appears in the first 30 results; it does not measure answer accuracy. Costs were not standardized across the runs.

Full-text question answering — 70 of 75 answers correct

AIPOCH ran the 75-question LitQA2-FullText Test split in AstaBench v0.5.4. The chart orders the local result and historical reference records by score. Its “#1” refers to that comparison.

AIPOCH Open-Science LitQA2 full-text question answering comparison: 93.33% local accuracy

Accuracy measures correct answers. Here, 93.33% is the local answer accuracy and 90.67% is a historical reference answer accuracy. The retrieval chart above uses a different metric. Reference records were captured on October 28, 2026; the highest reference score was checked again on November 2.

Cited-answer quality — local validation result and official test references

The local ScholarQA-CS2 result measures the quality of cited answers on 100 Validation questions. Reference results are from the Test split, so the scores do not establish a head-to-head ranking.

AIPOCH Open-Science ScholarQA-CS2 comparison: 0.9289 local Validation composite score, shown separately from official Test references

The composite score is reported on a 0–1 scale; it is not the percentage of questions answered completely correctly.

ASI-Bench — Following a plan and choosing methods

The four conditions ask the agent to execute a specified plan (B1), organize a workflow (B2), choose methods (B3), or work through distracting information (B4). The first two rows of the chart compare local runs using the same GPT-6 Astra model.

AIPOCH Open-Science ASI-Bench results alongside local Codex runs and published references across B1–B4

Open-Science scored 79.35, 56.11, 59.67, and 59.46 on B1–B4; the local Codex reference scored 74.78, 56.09, 58.12, and 55.45. The B2 scores were nearly identical. Other published runs differ in task instances, configurations, or judging.

The local B1 score covers 59 tasks after one scorer-related exclusion. Three local repeats were reported for B1/B2. B3/B4 used Open-Science v0.32.0 and a substitute judge; each score averages three 60-task runs.

BiomniBench-DA — Biomedical data analysis

On the Public 50 task set, the Gemini 3.1 Pro judge scored the outputs 81.04 and the DeepSeek v4-pro judge scored them 77.06. AIPOCH reports their equal-weight mean, 79.05, for the gpt-5.6-sol (xhigh) configuration.

Judge scores and historical references — judge coverage varies

The chart combines entries with different judge coverage. Its “#1” describes the ordering of that collection. A ranking under a common judging procedure would require comparable scoring for all entries.

AIPOCH Open-Science BiomniBench-DA Public 50 comparison showing two judge scores and their mean

79.05 is a mean judge score across this internal evaluation.

Evaluation scope: These reports cover local/internal runs from August to November 2026 with the stated models and splits; the evaluations were not rerun for the current release. Reference scores are historical snapshots, not live rankings. Scores from different benchmark families are not directly comparable, and numerical gaps do not establish statistical significance.

Read the AstaBench and ASI-Bench report and the BiomniBench-DA report for evaluation details.

Core Capabilities

AIPOCH Open-Science combines project management, multi-model agent execution, Python and R notebooks, scientific data connectors, immutable artifact versions with provenance, and permissioned human-in-the-loop control in one local workspace. The installed app and latest release notes are the source of truth for changing catalogs, packaging details, and newly added options.

Area Core capability
Scientific skills Extend research workflows with 24 built-in skills and 525 skills available from the Skills Marketplace, with one-click installation and updates. Create skills through conversation or completed work, import packages or GitHub sources, and save GitHub repositories for reuse in the import workflow. Saving a repository does not install its skills. Marketplace contributions are published after review; local imports do not publish skills.
Connectors Access scientific resources through 48 built-in connectors, or add custom local and remote MCP connectors. Some built-in sources are disabled by default and require per-source opt-in. Manage tool-level permissions and import or export connector configurations.
Specialists and delegation Install 10 Specialists from the Specialist Marketplace, or create and customize personal specialists for delegation from the main agent. Specialist packages support import and export; marketplace contributions are reviewed before publication, and local imports do not publish them.
Models and agent backends Use cloud models, compatible custom gateways, or Claude and Codex subscription logins. Choose from five agent backends — Claude Code, OpenCode, Codex, CodeBuddy, and Pi — with model connection checks, image input, and reasoning controls.
Projects, sessions, and research packages Organize projects with pinned sessions, message branches, side chats, and recoverable history. Export a portable .science research package and import it into another project or computer with conversation branches, selected file versions, Notebook records, and verification evidence. Imports are read-only and do not execute code or restore credentials; side chats and bookmarks are excluded, and included files depend on the export selection.
Reviewer Enable optional auto-review to check a completed agent turn's responses, execution logs, and related file evidence in a separate context. Get evidence-backed pass, warning, or failure checks, with a bounded cycle of main-agent corrections and re-review when issues are found. Review logs and issue-resolution states remain available; the review is limited to records available for that turn.
Python, R, notebooks, and HPC Run Python, R, Notebook, and shell workloads locally using managed environments or your own interpreters, with background execution and recorded history. Connect to remote hosts through SSH or submit work through Slurm; remote workloads require the host, software, resources, and permissions described in the remote-compute FAQ.
Literature Library Import and manage references and PDFs with collections, tags, project links, notes, and duplicate merging. Discover a paper’s references and citing works through Semantic Scholar, download and preview supplementary attachments, and drag and drop PDFs or bibliography files. Find open-access full text, read PDFs and extract figures and tables, and use library sources in conversations for AI-assisted analysis. For references with a valid DOI, manually check Crossref for known retractions or corrections; the check sends the DOI to Crossref, and incomplete coverage means no notice is not proof that a work is unaffected. Generate bibliographies, export references as BibTeX or RIS, and export Smart Screening decisions as CSV. Manually set reading status to Unread, In progress, or Finished reading, update selected references in bulk, and filter by status. Search personal notes from the existing reference search box. Generate paper overviews for up to five selected references, with two processed concurrently. Results are saved to each reference’s details; failures pause the remaining queue, which can be resumed or retried without regenerating saved results.
Scientific files and previews Upload individual files up to 10 GiB, organize project files, and preview scientific data, PDFs, Office documents, images, code, and molecular structures. This upload limit does not guarantee that a model can read an entire file: model context, attachment parsing, and previews have separate limits. Large files usually need chunked reading or analysis with code.
Artifacts and provenance Keep immutable artifact versions with available producer code, inputs, execution history, environment information, and review evidence. Import artifacts from authorized folders; AIPOCH Open-Science copies each imported file into managed artifact storage. In the desktop app, replay eligible versions with a complete recipe, required inputs, and a usable runtime, then compare outputs and export verification records. Missing evidence may prevent verification, and replay checks do not establish scientific validity.

When querying the eQTL Catalogue by genomic coordinates, use the GRCh38 assembly. The connector checks the assembly before looking up matches.

Import references, tags, collections, and source links from Zotero 10 or later running on the same computer, with the option to copy local PDF attachments. This is a one-way import into Open-Science and does not modify Zotero.

Add a reference using a DOI, arXiv ID, PMID, PMCID, or supported article link, or paste up to 100 references with one per line. Review and edit a single reference before saving, or select which references to import in a batch. Full-text PDFs can be added separately.

Persistent PDF annotations and document notes are available. With a screening model configured, smart collections evaluate references against your inclusion/exclusion criteria; AI decisions remain separate from manual decisions and support human review.

In reading mode, agents can list, locate, and create notes and marks on linked PDFs. PDF annotations are tied to the annotated file version and do not sync across computers.

Open a paper's detail view to generate an AI paper overview with your configured main model. The card identifies its source (full text or abstract) and summarizes the research question, study population, methods, main findings, and limitations.

Optional OCR recognizes scanned PDF pages after the component and required language packs have been downloaded. Nine language packs are available: English, Simplified Chinese, Traditional Chinese, German, Spanish, French, Japanese, Korean, and Russian. Page-level coverage indicators show which pages still lack text.

Translated PDFs can optionally reflow body text and captions into a single-column, content-first layout while retaining images, tables, formulas, and the bibliography in their original form, with source-to-output page mappings for comparison. On new setups, Notebook and Shell folder restrictions are enabled by default and confine those runtimes to the workspace, approved folders, and files required by tools; this setting does not control agent-native tools or remote computers.

In the desktop app, artifact provenance can also be exported as RO-Crate 1.1. A version-bound environment bundle can create a managed environment only when the captured bundle is complete and compatible with the target platform; this is separate from a full machine backup.

Browse research cases in the Marketplace from Home or the conversation workspace, filter by category, search by keyword, and download packages from case details.

Model Providers

AIPOCH Open-Science is model-agnostic at the product level: connect it to major cloud LLM providers, a custom gateway, or reuse an existing Claude or Codex subscription. Provider availability currently depends on the selected agent backend and the API protocols it supports. The following connection options are available:

Provider mode How it works
Built-in cloud providers Choose from the provider list shown by the installed app and authenticate with the requested key.
Custom Gateway Supply a Base URL and exact model ID with an API protocol supported by the selected agent backend (Messages, Chat Completions, or Responses), then run the connection test. Remote gateways require HTTPS and an API Key. Loopback endpoints such as localhost, 127.0.0.1, or [::1] may use HTTP without a key; presets include Ollama, LM Studio, llama.cpp, and vLLM. A default API format does not guarantee server or model compatibility.
Codex Subscription Select the Codex agent framework, then choose Codex Subscription as the provider type.
Claude Subscription Sign in with a Claude subscription in two modes: shared (a browser login that stores credentials in your default ~/.claude profile) or isolated (an app-managed claude setup-token run under an app-owned CLAUDE_CONFIG_DIR, fully isolated from ~/.claude/, with a browser flow plus a paste-a-token fallback).
xAI (Grok) OAuth Use the built-in xAI (Grok) OAuth device sign-in. Access depends on your xAI account and the selected backend’s protocol support; validate the connection in the app.

There are 25 preset provider options, including OpenAI, Anthropic, DeepSeek, NVIDIA Build, and others; available models and regional endpoints depend on the installed version and selected agent backend. Check the provider selector and connection test in the app.

Data, Permissions, and Trust

AIPOCH Open-Science stores project data, settings, artifact versions, and provenance evidence on the local computer. API Keys are kept locally and use the operating system's secure credential storage when it is available. Logs are local and are not uploaded automatically.

External data flow is still possible and should be reviewed:

  • Model requests send the prompt and necessary context to the selected model provider.
  • Web searches and remote connectors send their displayed parameters to external services.
  • Local connectors may execute trusted commands on the computer.
  • The application can also contact update servers, marketplace catalogs, and runtime or model download services.
  • Attachments, @ references, logs, and generated reports may contain sensitive research data.

Choose the narrowest permission profile that fits the task:

Mode Behavior Recommended use
Ask for approval Requests approval for actions not already covered by scoped grants or trusted application tool policies New workflows, sensitive data, unfamiliar scripts
Auto-approve edits Uses the backend's native auto review when available; otherwise automatically allows clearly low-risk workspace operations Trusted file-editing work with controlled external access
Full access Automatically allows edits, commands, network, and connectors Clearly scoped, fully trusted, unattended work

The effective profile depends on the selected backend and existing grants. Connector, tool, and compute-network policies also apply; check the effective mode shown by the app.

Review connector parameters and tool activity before approving them. Never include API Keys, access tokens, patient identifiers, unpublished data, or sensitive local paths in screenshots or public issue logs.

Development & Packaging

AIPOCH Open-Science has an ordinary Node backend and an Electron desktop client, built with React, TypeScript, Prisma/SQLite, and an ACP-based agent runtime.

Prerequisites for source development:

  • Node.js 24 (see .nvmrc) with npm
  • Git
  • Notebook execution optionally uses app-managed Python/R environments or a compatible interpreter you configure.
git clone https://github.com/aipoch/open-science.git
cd open-science
npm install
npm run dev

See the development command and packaging reference and contribution guide for build commands and the development workflow.

Localhost Web and standalone Node runtime

The same Web UI can run on an ordinary Node backend without Electron or a graphical display. Electron starts or attaches to that same Node service. One runtime owns each data directory.

npm run dev:web       # Build and run the Node backend + Web UI
npm run pack:backend  # Build a target-specific standalone npm tarball

For a published installation, use npm install --global @aipoch/open-science; the commands above are for source development. Install the package or locally built tarball, then run open-science start --no-open and open-science url to open the existing UI. See the standalone runtime guide for installation, secure credential storage, host capability boundaries and data compatibility.

The desktop app and browser share the same service. App connections and an explicit open-science start hold keep it running. Quitting the last App stops the service only when no explicit hold remains.

Mobile remote access

The same localhost web UI can be reached from a phone or tablet through Remote.It pairing. Pair a browser with a six-digit AIPOCH Open-Science code, approve it once on the desktop, and the workspace stays reachable without exposing the loopback server directly. Browser trust is revocable, and mode changes or service shutdown immediately invalidate active remote sessions.

Remote access requires the host to stay on and online, with AIPOCH Open-Science and the Remote.It agent running, and the host added to a signed-in Remote.It account. Browser approval has an expiry and can be revoked; see the Remote control guide.

Headless CLI and SDK

The headless CLI and zero-dependency Node.js SDK use the same local daemon, projects, sessions, credentials, and permissions as the desktop and web interfaces. Detailed usage lives with the publishable package so there is one command reference to maintain:

  • CLI guide - installation, service lifecycle, task automation, artifacts, output formats, and exit codes
  • SDK package overview - Node.js quick start and package entry point

The standalone CLI can expose its research tools to external MCP clients through open-science mcp. Start and authenticate the selected profile's service first. The adapter uses that profile's existing permissions; it is not a separate sandbox or read-only view, so connected clients can persist changes and incur model costs. It does not expose arbitrary shell or RPC access, credential management, file import/export, download-to-path operations, or a remote HTTP MCP endpoint.

Frequently Asked Questions

Why does the model connection test fail?

A: Check the API Key for missing characters or spaces, verify the Base URL and region, use the provider's exact model ID, and confirm network access and account balance. For a Claude subscription, retry the shared browser login or refresh the isolated claude setup-token credential, depending on the selected mode.

Why is Continue disabled during setup?

A: The current step has not met its required condition. Fix any environment row marked Action needed, install or repair the selected agent runtime, or validate the model provider, depending on the active step. Notebook setup is optional and only affects Notebook execution.

How do I run jobs on a remote HPC cluster?

A: Remote Compute (SSH) is always enabled and does not need to be enabled in Settings. Register an SSH compute host under Settings → Compute, make it available to the current session, and then use natural language or /remote-compute-ssh. You need a reachable SSH host, valid authentication, permission for the required directories, and the software, dependencies, and compute resources required by the workload. Direct SSH does not require a scheduler; Slurm mode requires a working Slurm environment and permission to submit jobs. “Always enabled” refers to the skill, not to the availability of every registered host.

Is there a command-line interface?

A: Yes. Install the standalone CLI, or use Settings → General → Command line tool → Install command to control an already running desktop instance. The npm installation requires Node.js; Homebrew and standalone bundled-runtime packages include it. Initialize the local profile, then control the service and submit research tasks without opening a browser:

# Initialize the local CLI profile and start the service in the background
open-science init
open-science start --no-open

# Create a project and run a task by its exact name
open-science project create "Systematic review"
open-science run --project "Systematic review" \
  --prompt-file ./task.md \
  --approval-profile auto \
  --skill literature-review \
  --wait --json

# Download a generated artifact
open-science artifacts list <session-id> --json
open-science artifacts download <artifact-id> --output ./report.md

See the CLI guide for the full command reference, JSON/JSONL output formats, exit codes, and headless service options.

How do I inspect where a generated result came from?

A: Open the generated artifact and choose Provenance. Select a version to inspect the content identity and the available producer code, execution history, inputs, environment inventory, producing conversation context, and reviewer evidence. Evidence AIPOCH Open-Science could not verify is marked unavailable.

Can I revise an earlier request without losing the conversation that followed?

A: Yes. Edit a completed user message and resend it to create a new branch from that point. The original later turns remain available, and the revision arrows beside the message switch between the alternative paths.

Contributors

Thank you to everyone who contributes code, documentation, translations, bug reports, and community support to AIPOCH Open-Science.

Contributors on GitHub

Get Involved

Help improve AIPOCH Open-Science: report a bug, suggest a feature, ask a question, or contribute. Choose a channel below to get started.

Channel Use it for
GitHub Issues Bugs, reproducible failures, and concrete feature proposals
GitHub Discussions Design questions, roadmap proposals, and longer technical conversations
Discord Community help, contributor coordination, and informal discussion
X / @aipoch_ai Release announcements and build-in-public updates
AIPOCH Open-Science website Official product overview and downloads

Before opening a public issue, remove API Keys, tokens, private file paths, unpublished data, patient identifiers, and other sensitive material from logs and screenshots. See CONTRIBUTING.md for the development workflow.

If AIPOCH Open-Science is useful to you, star the repository on GitHub.

For shipped, partial, and planned capabilities, see the Capability Map.

License

Apache License 2.0 — see LICENSE.

Star History

Explore related projects