Skip to content

Latest commit

 

History

2,135 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AIPOCH Open-Science

Open-source, local-first, model-agnostic AI research workbench for reproducible science.

Download Version DOI #1 BiomniBench-DA Public 50 Platforms macOS Windows Linux License Apache 2.0 Website aipoch.com Discord

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

AIPOCH Open-Science is an open-source, local-first, model-agnostic AI research workbench developed by AIPOCH for scientists and researchers. It enables reproducible, inspectable research with scientific AI agents, Python and R execution, scientific data connectors, and cross-platform support for macOS, Windows, and Linux. Create a project, describe your research goal in plain language, and let the agents read files, search the web, run code, query scientific data sources, and produce reports, tables, and figures with traceable provenance—all in one workspace.

AIPOCH Open-Science supports computational and data-intensive research across disciplines, including machine learning, statistics, life sciences, chemistry, materials science, physics and environmental science. It supports the research process from literature review and hypothesis development to code execution, data analysis, simulation, visualization, and the production of traceable research outputs.

💡 AIPOCH Open-Science v0.27.0 released (last updated September 2026). AIPOCH Open-Science v0.27.0 scales the literature workspace and lets long work run in the background: import many PDFs in one pass with per-file progress and retry, run Notebook and shell jobs in the background that deliver results automatically, and rely on a broad literature stability pass covering cross-client sync, data relocation, and import integrity. Core application skills stay always enabled, the headless CLI and Task SDK gain connector management, mermaid diagrams render more smoothly, and headless Linux deployments gain an explicit credential file store. See the latest release notes for full details.

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

Table of Contents

🚀 Quick Start

Get AIPOCH Open-Science running in three steps: download the installer for your platform, complete the guided first-run setup, and create a research project.

1. Download the app

Open the latest release, expand Assets, and choose the installer for your computer:

Your computer Choose
macOS — Apple Silicon (M1 or newer) The macOS DMG for Apple Silicon / ARM64
macOS — Intel The macOS DMG for Intel / x64
Windows x64 The Windows x64 installer
Linux x64 The Linux x64 AppImage or Debian package

Review the assets and verification information published on the release page. See Verifying your download before installation if you need to validate a package.

If macOS or Windows shows an unidentified-developer or unknown-publisher warning, verify that the package came from the official Releases page before continuing.

On macOS, you can also install with Homebrew:

brew install --cask open-science

Homebrew selects the Apple Silicon or Intel package automatically.

2. Complete first-time setup

The first launch has five guided steps:

  1. Environment checks compatibility, app storage, secure credential storage, and network access.
  2. Data location chooses where large artifacts, notebooks, uploads, and environments are stored.
  3. Agent runtime selects and prepares Claude Code, OpenCode, Codex, or CodeBuddy. App-managed runtimes can be installed without requiring Node.js, npm, or an administrator password.
  4. Model provider connects and tests the model you want to use. Choose a built-in provider, a custom gateway, or an existing Claude or Codex subscription login.
  5. Notebook runtime optionally prepares app-managed Python and R environments or enables detected and manually registered interpreters for either language.
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

Notebook execution is optional. Every required environment and agent-runtime check must pass before Continue becomes available, and the model connection must pass before setup finishes. Notebook and data-location settings can keep their defaults and be changed later in Settings. While a kernel is running, a Variables view can inspect the live Python or R namespace — names, types, shapes, and previews — read-only, refreshed after each execution.

3. Start a research project

  1. Click New project and give the project a stable research name and optional description.
  2. Open a session and describe the goal, input data, constraints, desired outputs, and how the result should be checked.
  3. Attach source files, select a verified model, and choose an approval mode.
  4. Send the task. Inspect the agent's tool activity, approve sensitive actions, and open generated artifacts in the preview panel.
  5. To explore a different direction, edit an earlier user message and resend it on a new branch; use the message revision controls to return to either path.
  6. Open an artifact's Provenance view to inspect its versions and the available evidence behind the selected result.
  7. Continue the work in later sessions. Use @ to reference an existing project file and / to explicitly select an enabled skill.

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

Product Tour

From a research request to a traceable result

Consider a representative bioinformatics task: reproduce a published differential-expression analysis, compare the regenerated results with the paper, and deliver the report, tables, and figures needed for review. The screenshots below are representative views from documented AIPOCH Open-Science workflows; they illustrate each stage rather than one continuous session.

1. Define the research task and evidence

Describe the research question, source paper and datasets, required methods or thresholds, expected outputs, and acceptance criteria. Upload supporting files or reference an existing project artifact with @, so the agent starts from explicit inputs instead of hidden context.

AIPOCH Open-Science paper reproduction task with the research conclusion, generated artifacts, and source comparison visible in one workspace

2. Execute with inspectable scientific tools

The agent can combine scientific skills, permissioned research connectors, searches, file operations, and Python or R code in the shared Notebook. Generated figures can be reviewed beside the research summary, while the artifact record exposes captured producer code and execution evidence for inspection.

AIPOCH Open-Science bioinformatics analysis showing the research summary, generated figure, and captured producer code side by side

3. Review reports, tables, and figures in place

The final response summarizes what reproduced, what differed, and which limitations matter. Generated Markdown reports, CSV tables, images, and other research artifacts remain attached to the session and are collected in the project file library, where they can be previewed beside the conversation and reused in follow-up work.

AIPOCH Open-Science reproduction result with differential-expression figures and generated files previewed beside the agent's explanation

4. Trace every artifact back to its evidence

Each generated artifact is stored as an immutable, checksummed version. Its Provenance view can expose the producing code and execution history, referenced inputs, observed environment inventory, producing conversation branch, and version-scoped Reviewer findings. Evidence that could not be verified is marked unavailable rather than inferred.

AIPOCH Open-Science research artifact preview with the Provenance entry for tracing a generated result

Benchmark Performance

🏆 #1 on BiomniBench-DA Public 50

AIPOCH Open-Science achieved the highest ranking score in the compiled BiomniBench-DA Public 50 comparison, earning 79.05 with gpt-5.6-sol (xhigh). The result combines a Gemini 3.1 Pro judge score of 81.04 and a DeepSeek v4-pro judge score of 77.06 through an equal-weight mean, placing AIPOCH Open-Science #1 among the collected Public 50 results. Explore the BiomniBench-DA dataset.

BiomniBench-DA Public 50 comparison showing AIPOCH Open-Science ranked first with a score of 79.05

Why AIPOCH Open-Science

AIPOCH Open-Science turns fragmented chats, notebooks, scripts, scientific databases, files, and reporting tools into one persistent, local-first AI research workbench where execution and evidence stay together.

  • Persistent execution. Projects, sessions, files, previews, and run history survive restarts, while approved agents can run commands, Python, and R and generate artifacts.
  • Traceable results. Immutable artifact versions preserve verifiable production evidence and clearly mark what is unavailable.
  • Model-agnostic choice. Connect built-in cloud providers, compatible custom gateways, or Claude and Codex subscriptions, then choose the model and reasoning effort for each session.
  • Local-first control. Application and project state stay on your computer; external calls use only services you configure or approve.
  • Open and extensible. The independent Apache-2.0 codebase, skills, connectors, tool activity, and generated files are inspectable, and you can add skills and MCP connectors.

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
Projects and sessions Create and organize projects with pinned sessions, persistent message branches and side conversations, and editable session details. Edit completed prompts into persistent, selectable message branches without deleting the original downstream path, and recover recent work, drafts, conversation history, and preview state.
Agent workflow Natural-language sessions with streamed responses, purpose-grouped tool activity, approval and stop controls, queued follow-ups, context compaction, and restart recovery. Branch completed work into new sessions; use structured clarifications, text, image, and PDF annotations, linked-PDF reading context, project memory, session references, and review-gated plans. Notifications, live status, timing and token details, the command palette, source previews, and project switching keep long-running research visible and manageable.
Models and agent backends Use built-in cloud providers including Apodex, NVIDIA Build with a curated agent-capable catalog, and the latest OpenAI and Anthropic model catalogs (GPT-6 Astra and Claude Fable 5.1), custom compatible gateways, or Claude and Codex subscription logins. Select Claude Code, OpenCode, Codex, or the login-free CodeBuddy runtime as the agent backend, with validated model and API compatibility, multimodal image input, reasoning controls, and dedicated subagent, reviewer, and Vision policies.
Specialists and delegation Create personal specialist agents with scoped capabilities, conversational customization, package import/export, and immediate handoff from the main agent. The signed-package marketplace supports official and user-approved GitHub sources, conflict-aware imports, and 64 built-in capability icons; production delegation adds durable messaging, recovery, and a per-session delegation switch.
Python, R, notebooks, and HPC Run persistent Python, R, and REPL kernels alongside recorded shell commands, using managed offline environments or your own interpreters. Work locally or connect to remote hosts over SSH and submit Notebook runs through Slurm on HPC clusters; protected network access, encrypted credentials, package and variable inspection, a shared terminal, and progressive history keep compute controlled and observable. Long Notebook, REPL, and shell work can run in the background — releasing the agent turn while keeping exact run identity, cancellation, and provenance, and delivering results automatically across local runs and remote compute jobs. Package management for external R runtimes remains manual.
Literature review and reference management Import references by DOI, PubMed ID, arXiv ID, or file — a single PDF through the metadata editor, or many at once with per-file progress, duplicate handling, and retry — and see the active library's reference total at a glance; organize collections, link references to projects, and recover downloaded PDFs from Trash. Search Europe PMC, PMC, OpenAlex, arXiv, and Unpaywall in parallel for open-access full text, merge duplicate records without losing attachments or links, and format citations from stored metadata with artifact provenance.
Scientific files and previews Attach files up to 10 GB with streaming upload; organize and search a project library; reference uploads, outputs, and local folders with @ and @path; and export files, conversations, or .ipynb sessions. Preview scientific data, searchable PDFs, Office files, TIFF and other images, source code, molecular structures and reactions, and Notebook history inline or full-screen, with provenance and return-to-source navigation.
Artifacts and provenance Keep immutable, session-scoped artifact versions with checksummed content, producer code, execution history, exact inputs, environment inventory, message-branch context, lineage, and reviewer evidence. Editable Markdown, text, scripts, and source code publish a new provenance-preserving version on every save, with predecessor comparison.
Scientific skills and data connectors Extend research workflows with 22 featured built-in skills and 24 built-in research connectors. Create skills conversationally or from completed work, import packages and GitHub sources, and add custom local or remote MCP connectors with tool-level permissions and configuration import/export. Core application skills stay always enabled so built-in entry points keep working, and the headless CLI and Task SDK can list, inspect, and enable or disable connectors. Cross-resource tags, a protected Favorites tag, and searchable filters organize skills, connectors, and specialists.
Local data, privacy, permissions, and verification Keep project data, application state, and Notebook caches local in configurable, migratable storage; use system, manual, or direct proxy modes and a token dashboard with a 30-day activity heatmap and per-run attribution. Control actions with Ask for approval, Auto-approve edits, or Full access, scoped grants, centralized credentials (with an explicit file-storage mode for headless Linux deployments), user-approved compute domains, and per-connector and per-tool policies. An opt-in reviewer audits transcripts, execution logs, and artifacts, reports pass/warn/fail findings, and can run a bounded fix loop with durable evidence.

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. There are four ways to connect a model:

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 compatible Base URL, API Key, and exact model ID. The default API format (Messages, Chat Completions, or Responses) is derived from the active agent framework, so a new custom gateway is compatible out of the box.
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).

The legacy Local Claude provider has been removed. Previously stored Local Claude entries are dropped during upgrade; add Claude Subscription and authenticate with shared browser login or the isolated claude setup-token flow instead.

Built-in cloud vendors currently include OpenAI, Anthropic, Grok (xAI), DeepSeek, Zhipu AI (GLM) with a dedicated GLM Coding Plan endpoint, Kimi (Moonshot), MiniMax, StepFun with a dedicated Step Plan subscription endpoint, Xiaomi MIMO, SenseNova, Volcengine Ark, Bailian (Alibaba Cloud) with a dedicated Bailian for Plan subscription endpoint, Tencent TokenHub plus dedicated Tencent Coding Plan and Token Plan subscription endpoints, OpenCode Go and OpenCode Zen, and the OpenRouter aggregation gateway, among others; some are region-specific.

Provider vendors, available models, and regional endpoints can evolve independently of this README. Treat the provider picker and connection test in the installed app as the source of truth.

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.
  • 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 Asks before edits, commands, network, and connector calls New workflows, sensitive data, unfamiliar scripts
Auto-approve edits Automatically allows workspace edits; asks for commands, network, and connectors Trusted file-editing work with controlled external access
Full access Automatically allows edits, commands, network, and connectors Clearly scoped, fully trusted, unattended work

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.

Project Status

AIPOCH Open-Science is an actively developed desktop application available for macOS, Windows, and Linux. Development focuses on reliable local-first research workflows, extensible scientific capabilities, traceable research artifacts, and user-controlled execution.

See the latest release for current downloads and version-specific changes. For shipped, partial, and planned capabilities, see the Capability Map.

AIPOCH Open-Science assists research execution and record-keeping; researchers remain responsible for methods, interpretation, privacy, and scientific validity.

Development & Packaging

AIPOCH Open-Science is an Electron application built with React, TypeScript, Prisma/SQLite, and an ACP-based agent runtime.

Prerequisites for source development:

  • Node.js 22 (see .nvmrc) with npm
  • Git
  • Python 3 only if you want Notebook execution
git clone https://github.com/aipoch/open-science.git
cd open-science
npm install
npm run dev

npm install automatically generates the Prisma client and installs Electron native dependencies. npm run dev builds the Electron main/preload bundles, starts the renderer, and opens the desktop app. Development data is isolated under ~/.open-science-project.

Useful commands:

Command Purpose
npm run dev Start the development application
npm run dev:web Dev app + localhost web UI (127.0.0.1)
npm run dev:headless Dev backend + web UI, no Electron window
npm run lint Run ESLint
npm run typecheck Type-check main and renderer code
npm test Run the Vitest suite
npm run build Type-check and build the application
npm run build:web Build the optional localhost web UI
npm run build:mac Package macOS builds
npm run build:win Package Windows builds
npm run build:linux Package Linux builds

Packaged output is written under dist/.

Localhost web and headless modes

The desktop backend can optionally serve the same renderer to a browser on the local computer. This feature is off by default and binds only to 127.0.0.1.

npm run build:web
npm run dev:web

Open the authenticated URL printed by the application. Use npm run dev:headless to start the backend, tray, agent runtime, and localhost web service without opening an Electron window. Set OPEN_SCIENCE_WEB_PORT to choose a port (default 44100). Explicitly quitting the application still shuts down agent and Notebook processes normally.

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.

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

Frequently Asked Questions

What is AIPOCH Open-Science, and who builds it?

A: AIPOCH Open-Science is an independent, open-source (Apache-2.0) research workbench built by the AIPOCH team. AIPOCH Open-Science is the full product name, while Open-Science is its short name. Both names refer to the same AIPOCH product.

What should I do the first time I open AIPOCH Open-Science?

A: Complete the five setup steps: Environment, Data location, Agent runtime, Model provider, and Notebook runtime. Fix required rows marked Action needed, install or repair the selected agent if offered, and test the model connection. Notebook setup and a custom data location are optional.

What is an API Key, and where do I get one?

A: An API Key is a secret credential issued by a model provider. Create or copy one from that provider's developer/API console. The provider may bill requests made with the key. Treat it like a password: never share it or commit it to a repository.

Do I need an API Key?

A: Not if you reuse an existing subscription login — a Claude subscription through shared browser login or an isolated app-managed claude setup-token flow, or a ChatGPT/Codex subscription login on the Codex backend. Built-in cloud providers and custom gateways require their own keys.

Which model providers can I use?

A: Open the provider picker during setup or under Settings → Model for the choices supported by your installed app and selected agent backend. You can use a built-in cloud provider, a compatible Custom Gateway, a Claude subscription through shared or isolated login, or a Codex subscription on the Codex backend.

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.

Setup is complete. How do I start a research task?

A: Create or open a project, start a session, attach any source files, and describe the goal, constraints, expected output, and validation criteria. Use @ to reference a project file and / to select an enabled skill.

How do I run jobs on a remote HPC cluster?

A: Enable the Remote Compute (SSH) skill under Settings → Skills, register your cluster under Settings → Compute, then start a session and select the skill with /remote-compute-ssh. The skill handles host registration, short commands via SSH, and fully async job submission — the app automatically starts an analysis turn when the job finishes, so you never write a polling loop.

Is there a command-line interface?

A: Yes. Install it in one click from Settings → General → Command line tool → Install command (adds open-science to your PATH; no separate Node.js needed). The CLI controls the local service and submits research tasks without opening a browser:

# Start the service in the background
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.

Does my research data stay on my computer?

A: Projects, sessions, files, settings, and configured credentials are stored locally by default. Content needed for model requests, web searches, or connector calls may still be sent to the external service you selected, so review sensitive inputs and provider policies before running a task.

Get Involved

AIPOCH Open-Science welcomes bug reports, feature proposals, design discussions, community questions, and contributions through GitHub, Discord, X, and the AIPOCH website. Choose the channel that best matches your goal, then follow the linked contribution guidance and public-posting safety reminder before sharing project details.

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.

Star the repo: If this project has been helpful, we'd greatly appreciate a star on GitHub. Starring the repository encourages continued development. It only takes a second, but it has a meaningful impact on the project.

License

Apache License 2.0 — see LICENSE.

Star History

Star History Chart

About

AIPOCH Open-Science is an open-source, local-first, model-agnostic AI research workbench for macOS, Windows, and Linux, with scientific agents, Python/R notebooks, data connectors, and reproducible provenance.

Topics

Resources

Contributing

Security policy

Stars

4.0k stars

Watchers

118 watching

Forks

Releases

Used by

Contributors

Languages