easyresearch 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hdu-ailab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# easyresearch
+
+Automated academic paper writing CLI with a local web panel.
+
+```sh
+npm install -g easyresearch
+easyresearch
+```
+
+Self-contained binary per platform (no Bun/Node required). On first run it
+creates a local Python venv (`markitdown`, `arxiv`) and extracts bundled
+agents/skills — watch the terminal for progress. Requires Python 3 on PATH
+for PDF conversion and arXiv SDK features; everything else works without it.
+
+```sh
+easyresearch          # start the web panel at http://127.0.0.1:3000
+easyresearch exit     # stop the background service
+easyresearch --version
+```
+
+Skip first-run setup with `EASYRESEARCH_SKIP_SETUP=1`.
+
+## Supported platforms
+
+linux-x64, darwin-arm64, windows-x64. On other platforms the install fails
+with a clear message — build from source instead:
+
+```sh
+git clone https://github.com/hdu-ailab/EasyResearch.git
+cd EasyResearch
+bun install
+bun run build:release -- --only <target>   # e.g. linux-arm64
+# binary at release/easyresearch-<target>/bin/easyresearch
+```
+
+See `scripts/build.ts` `TARGETS` for valid <target> names.

package/bin/easyresearch.exe

@@ -0,0 +1,4 @@
+#!/bin/sh
+# Placeholder replaced by postinstall.mjs with the platform binary.
+echo "easyresearch: platform binary not installed. Run: npm rebuild easyresearch" >&2
+exit 1

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "easyresearch",
+  "version": "0.0.1",
+  "description": "Automated academic paper writing CLI built on the Pi agent harness",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hdu-ailab/EasyResearch.git"
+  },
+  "keywords": [
+    "research",
+    "paper-writing",
+    "cli",
+    "ai",
+    "latex"
+  ],
+  "bin": {
+    "easyresearch": "./bin/easyresearch.exe"
+  },
+  "scripts": {
+    "postinstall": "node ./postinstall.mjs"
+  },
+  "optionalDependencies": {
+    "easyresearch-linux-x64": "0.0.1",
+    "easyresearch-darwin-arm64": "0.0.1",
+    "easyresearch-windows-x64": "0.0.1"
+  }
+}

package/postinstall.mjs

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+// postinstall for the `easyresearch` meta package.
+// Resolves the platform-specific binary package (easyresearch-<os>-<arch>),
+// copies the executable into ./bin/easyresearch.exe, and verifies it with
+// `--version`.
+//
+// Adapted from opencode-ai (https://github.com/sst/opencode, MIT licensed)
+// which ships a platform meta package in the same way.
+
+import childProcess from "child_process";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { createRequire } from "module";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, "package.json"), "utf8"));
+
+const platformMap = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+};
+const archMap = {
+  x64: "x64",
+  arm64: "arm64",
+};
+
+const platform = platformMap[os.platform()] ?? os.platform();
+const arch = archMap[os.arch()] ?? os.arch();
+const base = `easyresearch-${platform}-${arch}`;
+const sourceBinary = platform === "windows" ? "easyresearch.exe" : "easyresearch";
+const targetBinary = path.join(__dirname, "bin", "easyresearch.exe");
+
+function packageName() {
+  // Shipped platforms (see scripts/build.ts TARGETS):
+  //   linux-x64, darwin-arm64, windows-x64
+  return base;
+}
+
+function resolveBinary(name) {
+  const packageJsonPath = require.resolve(`${name}/package.json`);
+  const binaryPath = path.join(path.dirname(packageJsonPath), "bin", sourceBinary);
+  if (!fs.existsSync(binaryPath)) throw new Error(`Binary not found at ${binaryPath}`);
+  return binaryPath;
+}
+
+function installPackage(name) {
+  const version = packageJson.optionalDependencies?.[name];
+  if (!version) return;
+
+  const temp = fs.mkdtempSync(path.join(os.tmpdir(), "easyresearch-install-"));
+  try {
+    const result = childProcess.spawnSync(
+      "npm",
+      ["install", "--ignore-scripts", "--no-save", "--loglevel=error", "--prefix", temp, `${name}@${version}`],
+      { stdio: "inherit", windowsHide: true },
+    );
+    if (result.status !== 0) return;
+    const packageDir = path.join(temp, "node_modules", name);
+    copyBinary(path.join(packageDir, "bin", sourceBinary), targetBinary);
+    return true;
+  } finally {
+    fs.rmSync(temp, { recursive: true, force: true });
+  }
+}
+
+function copyBinary(source, target) {
+  if (!fs.existsSync(source)) throw new Error(`Binary not found at ${source}`);
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  if (fs.existsSync(target)) fs.unlinkSync(target);
+  try {
+    fs.linkSync(source, target);
+  } catch {
+    fs.copyFileSync(source, target);
+  }
+  fs.chmodSync(target, 0o755);
+}
+
+function verifyBinary() {
+  const result = childProcess.spawnSync(targetBinary, ["--version"], {
+    encoding: "utf8",
+    stdio: "ignore",
+    windowsHide: true,
+  });
+  return result.status === 0;
+}
+
+function main() {
+  const name = packageName();
+  if (!packageJson.optionalDependencies?.[name]) {
+    throw new Error(
+      `easyresearch does not ship a binary for ${platform}-${arch}. Supported platforms: linux-x64, darwin-arm64, windows-x64.`,
+    );
+  }
+  try {
+    copyBinary(resolveBinary(name), targetBinary);
+    if (verifyBinary()) return;
+  } catch {
+    if (installPackage(name) && verifyBinary()) return;
+  }
+
+  throw new Error(
+    `It seems your package manager failed to install the right easyresearch binary package. Try manually installing ${JSON.stringify(
+      name,
+    )}.`,
+  );
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(error.message);
+  process.exit(1);
+}