การติดตั้ง (Installer)¶

คู่มือเฉพาะแต่ละแพลตฟอร์ม¶

แพลตฟอร์ม	คำสั่งบรรทัดเดียว	คู่มือแบบละเอียด
macOS	`curl -fsSL https://open-jarvis.github.io/OpenJarvis/install.sh \\| bash`	ติดตั้งบน macOS
Linux	`curl -fsSL https://open-jarvis.github.io/OpenJarvis/install.sh \\| bash`	ติดตั้งบน Linux
WSL2 บน Windows	`curl -fsSL https://open-jarvis.github.io/OpenJarvis/install.sh \\| bash` (รันภายใน Ubuntu)	ติดตั้งบน WSL2
Windows แบบเนทีฟ	`irm https://open-jarvis.github.io/OpenJarvis/install.ps1 \\| iex`	ติดตั้งบน Windows แบบเนทีฟ
Desktop GUI	ดาวน์โหลดจาก release ล่าสุด	—

ตัวติดตั้งแบบ bash และ PowerShell ทำสิ่งเดียวกันบน host ของแต่ละฝั่ง เนื้อหาที่เหลือของหน้านี้อธิบายตัวติดตั้ง bash แบบละเอียด ส่วน คู่มือ Windows แบบเนทีฟ คือเอกสารอ้างอิงที่เทียบเท่ากันสำหรับ PowerShell

ตัวติดตั้งแบบ Bash¶

curl -fsSL https://open-jarvis.github.io/OpenJarvis/install.sh | bash

ตัวติดตั้งจะดาวน์โหลดทุกอย่างให้คุณ — รวมถึง uv (ตัวจัดการแพ็กเกจ Python), Python venv, Ollama และโมเดลเริ่มต้นขนาดเล็ก คุณไม่จำเป็นต้องติดตั้ง uv หรือสิ่งที่ต้องมีก่อนอื่นใดด้วยตัวเองก่อนเลย

URL สำหรับติดตั้ง

สคริปต์นี้ให้บริการโดยตรงจากเว็บไซต์ GitHub Pages ของโปรเจกต์เอง ดังนั้น HTTPS จึงใช้งานได้เสมอ คุณอาจเห็น https://openjarvis.ai/install.sh ถูกอ้างอิงไว้ในเอกสารรุ่นเก่า — โดเมนนั้นดูแลโดยชุมชนและเคยมีปัญหา TLS เป็นระยะ (#337) URL open-jarvis.github.io ด้านบนคือ URL หลักที่ควรใช้

ใช้เวลาประมาณ 3 นาทีบนการเชื่อมต่อบรอดแบนด์ทั่วไป พิมพ์ jarvis เพื่อเริ่มแชท

สิ่งที่ตัวติดตั้งทำ¶

เฟส	ขั้นตอน	ตำแหน่ง
Foreground	ติดตั้ง `uv` (ตัวจัดการแพ็กเกจ Python)	`~/.cargo/bin/` หรือ `~/.local/bin/`
Foreground	Clone repo ของ OpenJarvis	`~/.openjarvis/src/`
Foreground	สร้าง venv ของ Python 3.11	`~/.openjarvis/.venv/`
Foreground	`uv pip install -e .` (ติดตั้งแบบ editable)	venv
Foreground	ติดตั้ง Ollama	ค่าเริ่มต้นของระบบ
Foreground	เริ่ม `ollama serve`	systemd-user / launchd / nohup
Foreground	ดึงโมเดล `qwen3.5:2b` (~1.5 GB)	model store ของ Ollama
Foreground	เขียน `config.toml` (ฮาร์ดแวร์ + engine + โมเดลที่ตรวจจับอัตโนมัติ)	`~/.openjarvis/config.toml`
Foreground	สร้าง symlink `jarvis` และ `jarvis-uninstall`	`~/.local/bin/`
Foreground	เพิ่ม `~/.local/bin` เข้า PATH หากยังไม่มี (พร้อมข้อความแจ้งบนหน้าจอ)	`~/.bashrc` หรือ `~/.zshrc`
Background	ติดตั้ง Rust toolchain ผ่าน rustup	`~/.cargo/`
Background	Build maturin extension (ฟีเจอร์ memory + security)	venv
Background	ดึงโมเดลระดับฮาร์ดแวร์ปัจจุบันและระดับถัดไป	model store ของ Ollama

สิ่งที่ตัวติดตั้งไม่แตะต้อง¶

การติดตั้ง Python ที่คุณมีอยู่เดิม
~/.bashrc / ~/.zshrc ของคุณ นอกเหนือจากการเพิ่มบรรทัด PATH หนึ่งบรรทัด (พร้อมข้อความแจ้งบนหน้าจอ)
โมเดล Ollama ที่คุณมีอยู่เดิม
เครื่องมือหรือ dotfile อื่นใดๆ

การรันซ้ำแบบ Idempotent¶

การรันคำสั่ง curl ซ้ำนั้นปลอดภัย ตัวติดตั้งจะอ่าน ~/.openjarvis/.state/install-state.json และข้ามขั้นตอนที่ทำเสร็จแล้ว หาก venv ของคุณถูกทำลาย การรันซ้ำจะซ่อมแซมให้

Cloud Quick-path¶

หากมี env var เหล่านี้ตั้งค่าไว้ตอนติดตั้งหรือรัน jarvis init ตัวติดตั้ง/init จะเสนอ cloud เป็นค่าเริ่มต้น และเขียน provider ที่ตรงกันลงใน config.toml:

OPENROUTER_API_KEY
ANTHROPIC_API_KEY
OPENAI_API_KEY
GOOGLE_API_KEY (หรือ GEMINI_API_KEY)

Local-first ยังคงเป็นค่าเริ่มต้นเมื่อไม่มี key ใดๆ ใน env ลำดับความสำคัญคือ OpenRouter > Anthropic > OpenAI > Google

Flags¶

Flag	ผลลัพธ์
`--minimal`	ข้ามการดึงโมเดลแบบ foreground แชทครั้งแรกจะต้องรอให้การดึงแบบ background เสร็จก่อน
`--no-bg-orchestrator`	ไม่ detach pipeline งาน background (ส่วนใหญ่ใช้สำหรับทดสอบ)
`--force`	รันทุกขั้นตอนซ้ำแม้ `install-state.json` จะบอกว่าเสร็จแล้ว

การ Override ผ่าน Environment¶

ตัวแปร	ค่าเริ่มต้น	จุดประสงค์
`OPENJARVIS_HOME`	`$HOME/.openjarvis`	ตำแหน่งติดตั้ง
`OPENJARVIS_REPO_URL`	`https://github.com/open-jarvis/OpenJarvis.git`	repo ต้นทางสำหรับขั้นตอน clone

การถอนการติดตั้ง¶

jarvis-uninstall

ลบ ~/.openjarvis/, ~/.local/bin/jarvis และ ~/.local/bin/jarvis-uninstall ทิ้ง โดยไม่แตะ Ollama, uv และ Rust toolchain (เพราะอาจถูกใช้โดยเครื่องมืออื่น) สคริปต์จะแสดงคำแนะนำการลบให้ด้วย

การอัปเดต¶

jarvis update

ดึงซอร์สโค้ดล่าสุด รีเฟรชการติดตั้งแบบ editable และ build Rust extension ใหม่ในพื้นหลัง ไม่แตะต้องโมเดล

การแก้ปัญหา¶

"command not found: jarvis"¶

~/.local/bin ไม่ได้อยู่ใน PATH ของคุณ รัน source ~/.bashrc (หรือ ~/.zshrc) หรือเปิดเทอร์มินัลใหม่

"memory features unavailable"¶

Rust extension ยัง build ไม่เสร็จ (หรือล้มเหลว) ตรวจสอบสถานะ:

jarvis doctor

ลองใหม่ด้วยตนเอง:

~/.openjarvis/.scripts/install-rust.sh && ~/.openjarvis/.scripts/build-extension.sh

โมเดลขนาดใหญ่ดาวน์โหลดไม่สำเร็จ¶

ตรวจสอบสถานะและลองใหม่:

jarvis doctor
~/.openjarvis/.scripts/pull-model.sh qwen3.5:9b

อยู่หลัง Proxy ขององค์กร¶

ตั้งค่า HTTPS_PROXY และ CURL_CA_BUNDLE ใน environment ของคุณก่อนรันตัวติดตั้ง