better-me

agent
Guvenlik Denetimi
Basarisiz
Health Uyari
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 7 GitHub stars
Code Basarisiz
  • process.env — Environment variable access in apps/agent-host/scripts/check-identity.ts
  • network request — Outbound network request in apps/agent-host/scripts/verify-capability-live.ts
  • Hardcoded secret — Potential hardcoded credential in apps/agent-host/scripts/verify-capability-live.ts
  • os.homedir — User home directory access in apps/agent-host/scripts/verify-casdoor-live.ts
  • process.env — Environment variable access in apps/agent-host/scripts/verify-casdoor-live.ts
  • network request — Outbound network request in apps/agent-host/scripts/verify-casdoor-live.ts
  • Hardcoded secret — Potential hardcoded credential in apps/agent-host/scripts/verify-casdoor-live.ts
  • process.env — Environment variable access in apps/agent-host/scripts/verify-identity-compose.ts
  • network request — Outbound network request in apps/agent-host/scripts/verify-identity-deployment.ts
  • process.env — Environment variable access in apps/agent-host/scripts/verify-inventory-ui.ts
  • network request — Outbound network request in apps/agent-host/scripts/verify-inventory-ui.ts
  • Hardcoded secret — Potential hardcoded credential in apps/agent-host/scripts/verify-inventory-ui.ts
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Local-first Career OS & Evidence-Grounded AI Agent Workspace — 119 resume templates, 3D Job Atlas, official ATS discovery, and cross-platform desktop app.

README.md
BetterMe

BetterMe

Local-First Career OS & Evidence-Grounded AI Agent Workspace
Turn real experience into structured career assets, explore real employers in 3D, and stay in full control of your data.

English · 简体中文

🌐 Live Web Preview · 📦 Download Desktop App · 🚀 Quick Start · 📐 Product Boundaries · 🗺️ Roadmap

CI Latest Release Local-First Cross-Platform 3D Atlas

BetterMe Resume Studio — Calm Craft OS with live A4 preview


Why BetterMe?

Most "AI resume builders" are single-shot prompt wrappers: models invent metrics out of thin air, switching templates scatters your edits, and job applications disappear into disconnected tabs.

BetterMe separates Career Assets from Controlled Agent Execution:

Capability Typical AI Resume Tools BetterMe
Data Ownership Cloud lock-in, opaque retention 100% Local-First — SQLite + IndexedDB, exportable JSON & checkpoints
Factual Integrity Hallucinated numbers & silent rewrites Evidence-Grounded — unverified metrics stay isolated from exported resumes
Templates & Export A handful of rigid layouts 119 layouts (Native / RenderCV / JSON Resume) → PDF, DOCX, Markdown, YAML
Job Exploration Flat lists with stale links 3D Job Atlas + Official ATS discovery (Workday, Eightfold, Workable, SmartRecruiters)
Desktop Craft Generic web forms Calm Craft OS — tactile UI primitives, drag-to-reorder, customizable global shortcuts & Undo/Redo

✨ Key Features

1. Evidence-Grounded Resume Studio (Calm Craft OS)

  • Single Source of Truth (FactBase): Maintain experiences, verified metrics, causal context, and bilingual fields once; project into multiple role-targeted resume views without duplicating edits.
  • Tactile Desktop Editing: Smooth 60fps pointer drag-and-drop sorting for experiences, auto-growing text inputs with focus-reveal formatting toolbars, live A4 pagination follow, and zero-hallucination metric guards.
  • 119 Templates & Multi-Format Export: Switch seamlessly across curated, RenderCV, and JSON Resume themes; export print-ready PDF, editable DOCX (with optional photo), Markdown, and RenderCV YAML.

BetterMe Resume Studio, 119 templates, and evidence-anchored AI copilot

2. Customizable Global Shortcuts & Document Undo/Redo

  • Built-in Desktop Shortcuts: ⌘/Ctrl + Z Undo, ⇧ ⌘ Z / Ctrl + Y Redo, ⌘/Ctrl + S Save, ⇧ ⌘ S Version History, ⇧ ⌘ F Focus Mode, ⇧ ⌘ D Content/Design toggle, ⌘/Ctrl + K Find Jobs, ⌘/Ctrl + , Settings, and ⌥/Alt + 1–4 Workspace switching.
  • Live Keycap Recorder: Rebind any shortcut inside Settings → Keyboard Shortcuts with instant conflict detection and global effect.

BetterMe System Settings — Customizable Keyboard Shortcuts

3. 3D Job Atlas & Official Employer Discovery

  • Multi-Scale 3D Rendering: Seamless zoom from global/national clusters to street-level 3D buildings powered by MapLibre GL WebGL2 and Cesium, with offline Natural Earth fallback.
  • Official Career Discovery & Background Watch: Discover real openings directly from employer ATS platforms (Workday, Eightfold PCS, Workable, SmartRecruiters) using your resume's skills, role, and location—with background watch notifications and zero silent auto-apply.

BetterMe 3D Job Atlas and Nearby Company Radar

4. Controlled Career Agent, Practice Workshop & Autopilot

  • Unified AgentTaskKernel: JD breakdown, resume alignment, mock interviews, and multi-role review committees share one auditable task protocol, SHA-256 artifact storage, and pause/resume lifecycle.
  • On-Demand Practice Workshop: Turn real JD gaps into targeted exercises (writing, tradeoffs, scheduling, or sandboxed QuickJS coding tasks) with 24-hour independent transfer retests—works with local Ollama models.
  • 3D Opportunity Pipeline & 20-Node Autopilot: Track applications across stages and orchestrate reviewable workflows while keeping login, CAPTCHAs, and final submissions strictly under human control.

AI Career Advisor, Career Studio, 3D Opportunities, and Autopilot Studio

📸 View More High-Resolution Screenshots (Light / Dark / Modules)
Light Mode (ZH) Dark Mode
Resume Studio Light Resume Studio Dark
3D Atlas Panorama Nearby Company Radar
3D Atlas Panorama Nearby Company Radar
AI Career Advisor Autopilot 20-Node DAG Studio
AI Career Advisor Autopilot Studio

📦 Download & Try Now

🌐 Online Preview

Try the UI, 119 resume templates, and design system directly in your browser (static build, no local backend):
👉 https://nanfengovo.github.io/better-me/

💻 Desktop Installers (macOS / Windows / Linux)

Pre-built native Electron installers with bundled local services (agent-host + job-service) and verified SHA256SUMS are published on GitHub Releases:

Platform Architecture Installer / Archive Checksums
macOS Apple Silicon (arm64) .dmg · .zip SHA256SUMS-darwin-arm64.txt
macOS Intel (x64) .dmg · .zip SHA256SUMS-darwin-x64.txt
Windows x64 -setup.exe SHA256SUMS-win32-x64.txt
Linux x64 (glibc ≥ 2.34) .AppImage SHA256SUMS-linux-x64.txt

Note: macOS builds use ad-hoc signing and Windows builds are currently unsigned. Verify the published SHA-256 checksums before installation.


🚀 Quick Start

Option 1: Run from Source (Recommended for Developers)

Requirements: Node.js ^24.15.0 || >=26 and pnpm 11.9.0.

git clone https://github.com/nanfengovo/better-me.git
cd better-me
pnpm install --frozen-lockfile
pnpm dev

Open http://localhost:5173/. The dev entrypoint automatically launches the Web Studio (5173), agent-host (5179), and job-service (5178).

Option 2: Docker Compose (Self-Hosted)

git clone https://github.com/nanfengovo/better-me.git
cd better-me
docker compose up -d --build --wait

Open http://127.0.0.1:8080/. See docs/deployment.md for persistent volume and OIDC options.


📐 Architecture

flowchart LR
  subgraph Client["Desktop (Electron) & Web Studio (React 19 + Vite)"]
    DS["design-system<br/>Calm Craft OS Primitives"]
    RS["Resume Studio &<br/>119 Templates"]
    AT["3D Job Atlas<br/>MapLibre + Cesium"]
    AG["Career Agent &<br/>Practice Workshop"]
  end

  subgraph Core["Shared Workspace Packages"]
    PC["@better-me/core<br/>FactBase & Projection"]
    PS["@better-me/storage<br/>Checkpoints & Diff"]
    PO["@better-me/opportunities<br/>Pipeline & Scoring"]
    PA["@better-me/source-adapters<br/>Workday / Eightfold / Workable"]
  end

  subgraph LocalServices["Local-First Runtime (Loopback Only)"]
    AH["agent-host :5179<br/>AgentTaskKernel + QuickJS Sandbox"]
    JS["job-service :5178<br/>SQLite Index + Background Watch"]
  end

  Client --> Core
  Client <--> LocalServices
  LocalServices --> Core

Verification Commands

pnpm lint               # ESLint (--max-warnings 0)
pnpm typecheck          # Full Turborepo TypeScript check
pnpm test               # Complete unit & resume-quality suites
pnpm desktop:build      # Build & sync native Electron desktop runtime

🛡️ Privacy & Safety Boundaries

  • Local by Default: Resumes, checkpoints, job indices, and learning logs stay on your machine—zero telemetry, zero forced cloud sync.
  • No Silent Fabrication: Unverified metrics are visually flagged and filtered out of exported resumes until explicitly confirmed.
  • Human-in-the-Loop: External logins, CAPTCHAs, final submissions, and sandboxed tools always require explicit user confirmation.
  • Isolated Local Bridge: Development bridge routes bind to loopback with one-time expiring bearer grants and custom origin checks.

📄 Documentation & Releases

Yorumlar (0)

Sonuc bulunamadi