nichochar/ari

选用指南

AI 根据 README 整理 · 2026/10/19 12:11:08

适用场景

适合用纸笔练习数学、物理等学科，通过摄像头或照片上传让 AI 实时看到书写内容，进行提问和批改。

查看 README 依据

 Learn stuff with pen and paper + an AI tutor. Using pen and paper to actually solving problems is a very effective way for me to learn. It might be for you as well, and if so you might like Ari. I recommend setting up a camera above your page, I have [this one, it works great](https://www.amazon.com/dp/B079DLTG9F).  You can then chat with Ari about what you want to learn and it will create a curriculum for you with exercises to work through.

You can ask questions while you work and when you're done, just ask it to grade your work. It can always see what you are writing. I've had great success doing math and physics this way! Ari runs locally right now, which allows you to use your codex subscription. I've been using that with Astra (today Anthropic doesn't let you use your subscription for non-official clients). I recommend just pointing your AI to this repo and ask it to set it all up for you.  ## Run locally

使用方式

通过命令行启动本地服务，在浏览器中访问 http://127.0.0.1:3001 使用。

查看 README 依据

You need Node.js 24+, git, ffmpeg, and a chatGPT account. The built-in camera bridge is Mac-only, while browser cameras and photo uploads do not need it. ```sh git clone https://github.com/nichochar/ari.git cd ari npm ci npm install -g @openai/codex@0.163.0 codex -c 'cli_auth_credentials_store="file"' login ``` Complete sign in with chatGPT in your browser. Ari uses that local Codex login and your subscription's allowance, no API key needed. ```sh cp .env.example .env npm run build npm start ``` Open **http://127.0.0.1:3001**.

部署要求

需要 Node.js 24+、git、ffmpeg 和 ChatGPT 账户；内置摄像头桥接仅支持 Mac，浏览器摄像头和照片上传无需此功能。

查看 README 依据

You need Node.js 24+, git, ffmpeg, and a chatGPT account. The built-in camera bridge is Mac-only, while browser cameras and photo uploads do not need it. ```sh git clone https://github.com/nichochar/ari.git cd ari npm ci npm install -g @openai/codex@0.163.0 codex -c 'cli_auth_credentials_store="file"' login ``` Complete sign in with chatGPT in your browser. Ari uses that local Codex login and your subscription's allowance, no API key needed. ```sh cp .env.example .env npm run build npm start ``` Open **http://127.0.0.1:3001**.

已知限制

当前为单用户本地应用，建议仅在 localhost 使用；内置摄像头桥接仅支持 Mac。

查看 README 依据

Live camera preview stays local; deliberately submitted work and relevant learning context are sent to OpenAI for tutoring. This is a single-user local app—keep it on localhost. `npm run backup` saves learning data, native conversation history and personalization files, excluding credentials. Keep its SQLite file and companion directories together. `.env`, credentials, backups and personal learning data are not included in this repository.

You need Node.js 24+, git, ffmpeg, and a chatGPT account. The built-in camera bridge is Mac-only, while browser cameras and photo uploads do not need it. ```sh git clone https://github.com/nichochar/ari.git cd ari npm ci npm install -g @openai/codex@0.163.0 codex -c 'cli_auth_credentials_store="file"' login ``` Complete sign in with chatGPT in your browser. Ari uses that local Codex login and your subscription's allowance, no API key needed. ```sh cp .env.example .env npm run build npm start ``` Open **http://127.0.0.1:3001**.