Open-source, local-first, model-agnostic AI research workbench for reproducible science.
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.
- Quick Start
- Product Tour
- Benchmark Performance
- Why AIPOCH Open-Science
- Core Capabilities
- Model Providers
- Data, Permissions, and Trust
- Project Status
- Development & Packaging
- Frequently Asked Questions
- Get Involved
- License
- Star History
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.
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-scienceHomebrew selects the Apple Silicon or Intel package automatically.
The first launch has five guided steps:
- Environment checks compatibility, app storage, secure credential storage, and network access.
- Data location chooses where large artifacts, notebooks, uploads, and environments are stored.
- 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.
- 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.
- Notebook runtime optionally prepares app-managed Python and R environments or enables detected and manually registered interpreters for either language.
![]() |
![]() |
| 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.
- Click New project and give the project a stable research name and optional description.
- Open a session and describe the goal, input data, constraints, desired outputs, and how the result should be checked.
- Attach source files, select a verified model, and choose an approval mode.
- Send the task. Inspect the agent's tool activity, approve sensitive actions, and open generated artifacts in the preview panel.
- 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.
- Open an artifact's Provenance view to inspect its versions and the available evidence behind the selected result.
- 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.
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.
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.
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.
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.
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 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.
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.
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. |
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.
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.
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.
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 devnpm 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/.
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:webOpen 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.
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.
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
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.mdSee the CLI guide for the full command reference, JSON/JSONL output formats, exit codes, and headless service options.
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.
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.
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.
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.
Apache License 2.0 — see LICENSE.







