javis-os

Name: javis-os
Author: blogminhquy

Verified

183stars

113forks

Python

Added 8/29/2026

Installation

# Add to your Claude Code skills
git clone https://github.com/blogminhquy/javis-os

Getting Started

Guides for using ai agents skills like javis-os.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 8/29/2026

{
  "issues": [
    {
      "file": "CLAUDE.md",
      "line": 10,
      "type": "remote-install",
      "message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://x.ai/cli/install.sh | bash\"",
      "severity": "medium"
    },
    {
      "file": "README.md",
      "line": 95,
      "type": "remote-install",
      "message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://get.docker.com | sh\"",
      "severity": "low"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-08-29T10:49:51.219Z",
  "npmAuditRan": true,
  "pipAuditRan": false,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is javis-os?

javis-os is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by blogminhquy. It has 183 GitHub stars.

Is javis-os safe to use?

Yes. javis-os passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install javis-os?

Clone the repository with "git clone https://github.com/blogminhquy/javis-os" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is javis-os written in?

javis-os is primarily written in Python. It is open-source under blogminhquy on GitHub, so you can review or fork the full source.

Are there alternatives to javis-os?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh javis-os against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

244,042

airstore native-subtitle-quote-image

🧠 Javis OS

AI agentic đổi được bộ não + Second Brain - chạy trên model nào bạn muốn (Claude Code, ChatGPT/Codex, Antigravity CLI, OpenRouter, OpenAI, Gemini, Anthropic API, Groq, Ollama), có giọng nói, đồ thị tri thức, và tự thông minh dần lên.

Tiếng Việt · English

Javis là gì?

Javis OS không phải một chatbot. Nó là một AI agentic tự host chạy trên máy/VPS của bạn: đọc/ghi file, gọi công cụ (MCP), chạy skill, giao việc chạy nền, tự đặt lịch - rồi gói tất cả vào một dashboard đẹp, điều khiển bằng giọng nói, kèm một Second Brain (bộ nhớ + wiki) tích luỹ tri thức theo thời gian.

Bộ não thì bạn chọn, và đổi lúc nào cũng được. Mười đường dùng được ngay: Claude Code, ChatGPT/Codex và Antigravity CLI (dùng chính gói subscription bạn đang trả, không cần mua API riêng), Gemini CLI · OpenRouter · OpenAI API · Google Gemini · Anthropic API · Groq · Ollama Cloud (chỉ cần API key).

⚠️ Đọc trước khi cho gói subscription chạy việc nền. Anthropic chỉ tính gói Claude Pro/Max cho việc dùng cá nhân, thông thường của Claude Code. Chạy nền liên tục (loop, nhắc hẹn, việc Kanban, chatbot), chạy trên VPS, hoặc nhiều người dùng chung một tài khoản đều nằm ngoài phạm vi đó, và đã có người bị khoá tài khoản vì lý do này. Javis không tự đọc token đăng nhập của bạn (đường đó đã gỡ ở 0.26.17) - nó chạy qua đúng binary claude, nhưng như vậy vẫn không làm việc chạy nền 24/7 trở thành hợp lệ. Muốn yên tâm: ở trang Models, đặt Claude Code chạy bằng API key, hoặc trỏ model việc nền sang một provider khác. Xem server/claude_auth.py.

Triết lý: năng lực nằm ở Javis, không nằm ở model. Mọi bộ não đều được cấp cùng bộ đồ nghề qua trung tâm kết nối (MCP Hub) chung - MCP đã đấu, tool đọc/ghi brain, skill, việc Kanban, agent/workflow/loop/nhắc hẹn. Khác biệt duy nhất: hai engine CLI chạy thêm được lệnh máy. Đổi từ Claude sang Gemini không làm Javis mất chức năng nào ngoài chuyện đó.

Bạn đấu các kết nối của riêng mình vào (bán hàng/POS, quảng cáo, lịch, email, Zalo, ghi chú…) → Javis tự phát hiện và báo cáo kinh doanh + cuộc sống bằng số liệu thật, nói chuyện như người.

Vì sao Javis khác biệt

	Chatbot thường	Javis OS
Bộ não	Khoá cứng 1 model, API gọi rời từng câu	Đổi được: 10 nhà cung cấp, cái nào cũng đủ tool, MCP, skill, session
Trí nhớ	Quên sau mỗi phiên	Second Brain sống - nhớ bạn, dày lên qua từng hội thoại
Dữ liệu	Bịa hoặc không có	Số liệu thật từ kết nối bạn đấu vào (POS, Ads, Lịch, Zalo…)
Tự cải thiện	Không	Vòng lặp tự chạy nền + hàng đợi việc do AI tự vận hành
Giao diện	Khung chat	Dashboard + đồ thị tri thức + giọng nói rảnh tay + Telegram
Triển khai	Khoá vào 1 nhà cung cấp	Tự host: Hostinger 1-click / Docker / VPS bất kỳ

💡 Triết lý: Javis biên dịch một lần tri thức từ ghi chú thô → Wiki, rồi duy trì nó sống cùng mỗi nguồn mới. Tri thức tích luỹ, không tái phát hiện mỗi lần.

✨ Tính năng nổi bật

🎙️ Trò chuyện bằng giọng nói rảnh tay - nói, Javis nghe và trả lời bằng giọng. Chọn được nhà cung cấp giọng đọc: Edge TTS (miễn phí, mặc định), OpenAI hoặc ElevenLabs.
🌌 Đồ thị tri thức - bộ não của bạn hiện ra thành mạng note nối nhau qua [[wikilink]], bằng canvas nhẹ và chạy được ngoại tuyến.
💬 Phiên hội thoại - lưu / mở lại / tìm kiếm toàn văn mọi cuộc trò chuyện cũ; phiên dài được nén tóm tắt thay vì cắt cụt trí nhớ.
🗂️ Quản lý tệp tin - duyệt, sửa file .md/.txt trực tiếp trong trình duyệt, tìm file theo tên hoặc theo nội dung, tải lên/về.
🧩 Skills - gom nhóm, tìm kiếm, bật/tắt từng skill, thêm/sửa/xoá, nhập/xuất gói; Javis tự xếp skill mới vào đúng nhóm.
🧰 Plugins - thả một thư mục Python vào là có thêm tool/hook native cho MỌI engine, không phải sửa lõi.
🤖 Agents & Workflows - tạo trợ lý chuyên biệt (có bộ nhớ riêng) + chuỗi tự động nhiều bước, có bước kiểm chứng.
♻️ Việc định kỳ & nhắc hẹn - nhiều vòng lặp chạy nền song song, mỗi vòng làm đúng một việc bạn mô tả rồi tự kiểm chứng; kèm nhắc hẹn theo giờ cố định hoặc cron.
🗃️ Việc (Kanban) - giao một "goal" bằng lời, AI tự đặc tả, chọn worker, chạy nền và chỉ gọi bạn khi có ngoại lệ.
🧠 Tự học - sau mỗi hội thoại Javis tự rút ký ức, đúc tri thức Wiki và kỹ năng; mỗi lần học là một commit git nên hoàn tác được một chạm.
🔌 Kho kết nối đa tài khoản - Pancake POS, Zalo, Meta/Google/TikTok Ads, Google Workspace, Slack, Webcake, Substack… nhiều tài khoản cùng một dịch vụ, mỗi tài khoản một mức quyền riêng, Javis chặn cứng thao tác vượt quyền.
📱 Telegram & Zalo - hỏi Javis qua Telegram; đọc, tìm lịch sử và gửi tin Zalo bằng MCP chuẩn của zalo-agent-cli.
🎨 Tạo ảnh bằng chính gói ChatGPT đã đăng nhập, không cần API key riêng.
📊 Mức dùng - Javis tự đo token vào/ra và chi phí theo ngày, theo nhà cung cấp, tách rõ phần bạn gõ tay với phần Javis tự chạy nền.
⇅ Sao lưu brain lên GitHub - đồng bộ 2 chiều mọi brain lên một repo riêng tư, dùng chung giữa máy nhà và VPS.
🔄 Đa engine, đổi không mất chức năng - Claude Code, ChatGPT (Codex), OpenRouter, OpenAI API, Google Gemini, Anthropic API, Groq. Đổi trong Models một cú bấm; bộ não nào cũng gọi được MCP Javis, tool file brain và skill.
🔐 An toàn khi lên VPS - tự bắt buộc đăng nhập khi chạy public, chống chiếm tài khoản, rate-limit, chặn CSRF, mã hoá khoá bí mật trong cấu hình.

🚀 Cài đặt

⚠️ Quan trọng về bảo mật: Javis chạy bộ não AI với toàn quyền trên máy. Khi chạy public (Docker/VPS/Hostinger), Javis tự bắt buộc đăng nhập - mở app ra là màn tạo tài khoản / đăng nhập, không ai điều khiển được khi chưa có mật khẩu.

Cách 1 - Hostinger Docker Manager (tên miền + HTTPS) ⚡

VPS Hostinger → Docker Manager → Compose → URL → dán file Hostinger rồi Deploy:

https://raw.githubusercontent.com/blogminhquy/javis-os/main/docker-compose.hostinger.yml

Ô Environment của mẫu mới chỉ còn 3 trường cần thiết: DOMAIN_NAME, JAVIS_ADMIN_USER, JAVIS_ADMIN_PASSWORD. Các biến kỹ thuật về cổng, state, brain và thư mục chạy đã được ẩn vì Docker image tự đặt đúng.

Đặt DOMAIN_NAME để Traefik của Hostinger cấp HTTPS:

Link miễn phí (không cần mua tên miền): DOMAIN_NAME=javis.<hostname-vps>.hstgr.cloud (hostname xem ở hPanel → VPS, vd javis.srv1562015.hstgr.cloud).
Tên miền riêng: DOMAIN_NAME=tenmien.com + trỏ DNS A về IP VPS.

Deploy → đợi 1-3 phút Traefik cấp SSL → mở https://<DOMAIN_NAME>. (Chi tiết + xử lý sự cố: DEPLOY.md.)

Chỉ muốn chạy nhanh bằng http://<ip>:7777 (chưa cần tên miền): dùng docker-compose.yml (Cách 2).

3 việc làm 1 lần:

Để image GHCR ở chế độ Public: GitHub → repo → Packages → javis-os → Package settings → Visibility = Public.
Tạo tài khoản admin (chọn 1):
- Khuyến nghị: điền sẵn JAVIS_ADMIN_USER + JAVIS_ADMIN_PASSWORD đang có trong ô Environment → mở app đăng nhập luôn.
- Hoặc: mở app sẽ hỏi MÃ THIẾT LẬP - trong App terminal (vào bên trong container) chạy: cat /data/state/.setup_token.
Đăng nhập bộ não: App terminal → claude auth login --claudeai → mở link, dán code. (Dùng gói ChatGPT thì đăng nhập ở trang Models sau khi mở app.)

Cách 2 - Docker trên VPS bất kỳ (pull image, không cần clone)

# Cần Docker (chưa có?  curl -fsSL https://get.docker.com | sh)
mkdir javis && cd javis
curl -fsSLO https://raw.githubusercontent.com/blogminhquy/javis-os/main/docker-compose.yml

docker compose run --rm javis claude auth login --claudeai   # đăng nhập Claude 1 lần
docker compose up -d                                          # pull image + chạy

Mở http://<ip-vps>:7777 → màn tạo tài khoản admin (xem MÃ THIẾT LẬP trong docker compose logs javis).

Cách 3 - Cài trực tiếp lên Linux/macOS (không Docker)

git clone https://github.com/blogminhquy/javis-os.git javis && cd javis
chmod +x install.sh && ./install.sh

Script tự cài Python + Node + hai engine CLI (Claude Code, Codex), tạo venv, đăng ký dịch vụ systemd tự chạy khi boot, in ra địa chỉ. Báo Claude chưa đăng nhập thì chạy 1 lần: claude auth login --claudeai.

🍎 macOS - mở như một app: sau khi cài xong, double-click JAVIS OS.app (hoặc Start JAVIS OS.command) để chạy server + mở dashboard; tự chạy khi đăng nhập máy: ./bin/javis-autostart.sh install. Chi tiết: bin/README.md.

Cách 4 - Windows (máy cá nhân)

1. Cài Python 3.12 (tick "Add to PATH") + Node.js LTS
2. Double-click  setup.bat   (chạy hiện cửa sổ - tự cài Claude Code + Codex)
   Lần sau muốn chạy ngầm: start-javis.vbs   (log ở server\javis.log)
3. Mở http://localhost:7777 → trang Models, đăng nhập bộ não muốn dùng
4. Dừng: stop-javis.bat

🪟 Windows - mở như một app: sau khi setup.bat chạy xong lần đầu, từ đó về sau chỉ cần double-click JAVIS OS.bat - server tự chạy nền (không cửa sổ đen) rồi dashboard tự mở thành cửa sổ riêng không thanh địa chỉ, có ô riêng trên taskbar. Tự chạy khi đăng nhập máy: javis-autostart.bat install (gỡ: uninstall).

Nhiều bản Javis trên cùng một VPS (mỗi bản một link riêng)

Chạy được bao nhiêu bản cũng được - brain, cài đặt và tài khoản của mỗi bản tách bạch hoàn toàn. Chỉ cần ba giá trị khác nhau giữa các bản: JAVIS_NAME, JAVIS_HOST_PORT, DOMAIN_NAME.

Hostinger: deploy docker-compose.hostinger.yml thành stack thứ hai, điền ba ô đó.
VPS tự quản: chạy proxy dùng chung docker-compose.proxy.yml một lần cho cả máy, rồi mỗi bản một thư mục riêng dùng kèm docker-compose.multi.yml. Proxy tự phát hiện bản mới, tự xin SSL - thêm bản không phải sửa gì ở proxy.
Native: JAVIS_NAME=javis-shop JAVIS_PORT=7778 ./install.sh.

Bỏ trống các biến = y hệt cách cài cũ. Từng bước một: DEPLOY.md.

📄 Chi tiết