Jobs_Applier_AI_Agent README

The project's README from github.com/feder-cr/Jobs_Applier_AI_Agent. As one markdown file: README.md.

invisible_dots, an open-source, self-hosted alternative to OpenAI Dots, Meta Muse, Grok Bot, Manus Cue and Claude Cowork. An animation of what a Dot does: asked once in its chat to save a shop's invoices every month and send the total to Telegram, it works on a computer of its own (a desktop, a terminal, files and a Firefox that keeps the shop's login), writes the steps down as a skill, asks before it adds the monthly automation, and then sends the total every month; several Dots, one computer each.

Open-source, self-hosted alternative to OpenAI Dots, Grok Bot. Built to be undetectable by anti-bot systems.

Quickstart

You need Node 24+, Go 1.25+, Git and hardware virtualization (x86-64), plus an OpenRouter key.

Windows (PowerShell):

winget install -e --id OpenJS.NodeJS.LTS; winget install -e --id GoLang.Go; winget install -e --id Git.Git
git clone https://github.com/feder-cr/invisible_dots; cd invisible_dots
npm ci; npm run build --workspace @invisible-dots/cli
node apps/cli/dist/invisible-dots.mjs setup --all
node apps/cli/dist/invisible-dots.mjs server

Linux (Ubuntu 24.04):

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - && sudo apt-get install -y nodejs git && sudo snap install go --classic
git clone https://github.com/feder-cr/invisible_dots && cd invisible_dots
npm ci && npm run build --workspace @invisible-dots/cli
node apps/cli/dist/invisible-dots.mjs setup --all
node apps/cli/dist/invisible-dots.mjs server

setup --all installs QEMU and turns on the accelerator (KVM, or the Windows Hypervisor Platform), then builds or downloads the Dot's images; run it again after a restart and it carries on. Then open http://127.0.0.2:3000, paste your OpenRouter key and create your first Dot. Every step and its failure modes: the guide's quickstart.

What to ask a Dot

Anything that needs a computer and a person's judgement, for as long as it takes:

Open a browser identity called research, go to https://example.com and tell me the page's title and its first sentence. Leave the browser open.

Every morning, check one-way fares from Milan to Lisbon for the next two weeks, write them to ~/workspace/fares.csv and tell me the cheapest day.

Log in to the shop with the shopping identity, download this month's invoices to ~/documents, and remember where the invoices page is for next time.

What a Dot has

A computer of its own A hardware-accelerated VM with a Linux desktop and a persistent disk. It sleeps when idle and wakes for the next message, task or automation.
A browser that is not blocked invisible_playwright_mcp: Firefox patched in C++, the fingerprint set inside the engine. Each identity keeps its own cookies and logins.
Memory and skills It writes its own notes and how-tos in its home folder, as Claude Code does, and reads them on the next task.
Your MCP servers Any MCP server you declare, a program on its computer or a URL, as in Claude Code. Its keys stay out of the config.
Permissions you set Every tool belongs to a permission: allow, ask or deny. An ask waits in your Inbox, survives a restart and runs the call once.
Tasks and automations A queue with priorities and start times, and its own recurring jobs, for which its computer is started on time.
Many ways to reach it Web UI, command line, HTTP API with live events, Telegram, and WhatsApp as an opt-in.
Nothing lost on a crash A restart or a kill -9 keeps every message and task you saw accepted, and a tool call cut short is never run twice.

Documentation

The pieces of this one. A Dot's browser is invisible_playwright_mcp, on invisible_playwright and invisible_core; the engine is a fork of nanobot.

License

MIT, see LICENSE. Third-party components and their licenses: THIRD_PARTY_NOTICES.md.

Disclaimer

This project is provided as-is, with no warranties. Use it at your own risk and in compliance with the laws of your jurisdiction. A Dot acts with your accounts and from your connection: respect the terms of the sites it visits and their robots.txt.


tests license: MIT status: alpha hosts: Linux and Windows

Built by Federico Elia

Jobs_Applier_AI_Agent (feder-cr/Jobs_Applier_AI_Agent)

Searching Database…

这是干什么的?AIHawk 是一个开源的 AI 浏览器代理,它能不被察觉地浏览网页:它控制一个隐身版 Firefox,反爬虫系统看到的就像一个普通人在上网,所以不会遇到验证码,也不会被封。你用大白话说出想要什么,它就会浏览网页、点击、输入、读取真实网页,把事情办成。
这是需要注册使用的在线服务,还是我自己在本地运行的工具?是自己在本地运行的:它是自托管的,没有自己的服务器。有两种使用方式——通过 MCP 接入你的助手,或者运行独立的网页界面,左边是聊天窗口,右边是实时浏览器画面。
怎么把它跑起来?两条路。走 MCP 的话,先运行对应你操作系统的一行安装命令,然后告诉你的助手——Claude Code、Codex 或 Gemini CLI——它存在。走独立界面的话,运行命令后打开本地页面 127.0.0.1:8765(默认的主机和端口),然后在聊天框里输入你想要的东西。
运行它需要 OpenRouter 的密钥吗?独立网页界面需要——你得自备 OpenRouter 密钥,可以通过 --openrouter-key 参数、OPENROUTERAPIKEY 环境变量或 .env 文件提供。走 MCP 的话不需要单独的密钥:你接入的那个助手用它自己运行的模型。模型默认是 z-ai/glm-5.3-flash,可以用 --model 修改。
运行的时候有什么要注意的?有几点:如果把界面暴露到 127.0.0.1 之外,是没有任何身份验证的;用命令行参数传密钥会留在你的 shell 历史记录里,所以建议用环境变量或 .env 文件;另外自定义的 --binary 必须和指定的构建版本完全一致,否则启动会直接拒绝。还有,请阅读你要自动化的那些网站的服务条款,并遵守它们的访问频率限制。
能在 macOS 上运行吗?README 里只写了 Windows(PowerShell)和 Linux 的安装命令——没有提到 macOS。大概率能跑,但官方没有说法。
用的时候,我的电脑会有哪些数据发出去?三个渠道:你访问的网站看到的浏览器和普通 Firefox 没区别;你的模型服务商会在你的 OpenRouter 密钥下收到对话内容和页面内容;GitHub 会收到下载引擎的普通 HTTPS 请求,设置了代理时还有 GeoIP 数据库的请求,以及一个匿名的每次启动计数器。会话、配置文件和截图都留在本地,你可以随时删除。
授权协议有什么要注意的吗?就目前的版本来说没问题:MIT。但要注意的是,2026 年 9 月 2 日之前分发的所有版本都是 AGPL-3.0,而且会一直保持该协议,所以旧版本带有 copyleft(传染性开源)义务。
它是怎么做到不被反爬虫系统发现的?它像真人一样控制一个隐身版 Firefox——鼠标会移动、按键会被按下——所以反爬虫系统看到的是一个正常用户,而不是一段脚本。用 --seed 可以在多次运行之间固定一个稳定的浏览器身份,设置了 --proxy 时,时区、语言环境和出口 IP 都会跟随代理。
它适合做什么样的任务?所有需要真实网页自动化的活儿:要用浏览器而不是接口,还要对页面内容有人一样的判断。README 里的例子是在航空公司网站上逐天查机票价格——点击日历控件而不是直接输入日期,读取每天最便宜的票价,某天没票就如实报告,而不是瞎编一个数字。
我可以不聊天,直接写代码调用引擎吗?可以。同一个包还附带 invisibleplaywright——一个 API 和 Playwright 一致的 Python 库,用来写代码而不是写提示词;还有 invisiblecore,它把一个种子转换成浏览器指纹、偏好设置、代理和地理位置。MCP 服务器也在里面:'aihawk' 不带子命令就是服务器,'aihawk ui' 打开界面。
重启之后,我的登录状态和 Cookie 还在吗?只有你主动保存才会:传入 --profile-dir 并指定一个存放配置文件的目录,登录状态和 Cookie 就能在多次运行之间保留。配置文件和截图都存在本地,你可以随时删除。
Creator
feder-cr
Size
119.3 MB
Stars
32.3K
Age
2y
Commits · 90 Days