fullstack-agent README

The project's README from github.com/jaredrhod/fullstack-agent. As one markdown file: README.md.

fullstack-agent

Never used Claude Code? Start at jaredrhod.com: pick your situation and it routes you to the right path.

Runs on: Claude Code only; the installer itself is a Claude Code wizard. The $20 Pro plan is enough.

Not an agent that writes full-stack code. An agent that HAS a full stack: memory, voice, and face, plus an optional set of hands. This repo assembles my whole setup on your machine in one guided conversation, and when it finishes, your screen is a living circuit board with your agent's name on the chip, and it speaks first:

"Hello [you], what are we working on today?"

Watch the tour: My Jarvis AI Assistant, free on GitHub

Nine minutes shows you everything you're about to get (the voice, the face, the memory, and the hands): the tour video above, straight from my own desk.

That's not a demo clip. That's minute one.

What you get

Four pieces, each its own open repo, each excellent alone, assembled here into one agent:

Every piece is optional. The wizard asks which ones you want and explains each in plain English before you decide.

Install

You need Claude Code with a Claude subscription. Mac and Linux also use git (macOS offers to install it the first time you use it). Windows needs nothing else: the installer sets up git for you during setup. Then one paste into your terminal.

Mac and Linux:

mkdir -p ~/my-agent && cd ~/my-agent && git clone https://github.com/jaredrhod/fullstack-agent && cd fullstack-agent && claude "set me up"

Windows (PowerShell):

$d="$env:USERPROFILE\.local\bin"; if (Test-Path "$d\claude.exe") { $env:Path="$d;$env:Path" }; New-Item -ItemType Directory -Force -Path $HOME\my-agent | Out-Null; cd $HOME\my-agent; if (-not (Test-Path fullstack-agent\fullstack-agent.md)) { Invoke-WebRequest https://github.com/jaredrhod/fullstack-agent/archive/refs/heads/main.zip -OutFile fsa.zip; Expand-Archive fsa.zip . -Force; New-Item -ItemType Directory -Force -Path fullstack-agent | Out-Null; Get-ChildItem fullstack-agent-main -Force | Copy-Item -Destination fullstack-agent -Recurse -Force; Remove-Item fullstack-agent-main -Recurse -Force; Remove-Item fsa.zip }; cd fullstack-agent; if (Get-Command claude -ErrorAction SilentlyContinue) { claude "set me up" } else { Write-Output "Claude Code is not installed yet. Install it first at https://jaredrhod.com/start then paste this again." }

(The Windows command downloads the toolbox as a zip on purpose, so it works on a machine with no git installed. The installer sets up git for you during setup. Safe to paste as many times as you like: it skips the download when the toolbox is already there, and if an earlier attempt died partway and left a half-finished folder, it downloads again and finishes the job rather than assuming it was already done. If it tells you Claude Code is not installed yet, do the start page first. Heads up for that step on Windows: the Claude Code installer downloads about 330 MB and prints nothing at all while it does, so leave that window alone until it says Installation complete.)

Claude Code opens with the installer already talking to you. (The agent lives in a folder right in your home directory on purpose: on Macs, things that run in the background out of Documents get silently blocked by the system.) Everything after that is a conversation: it asks for your agent's name and personality (or hands you mine, Jarvis, ready to use), which pieces you want, and where your notes live. It does the installing, the configuring, and the wiring itself.

Already built some of this?

Then you're exactly who this was designed around. If you set up a memory vault, a voice system, or a visualizer before, including the ones my old prompts had your AI hand-build, the wizard adopts before it installs:

After setup

The fine print that matters

The rest of it

Everything here is free and open, and there is a whole community using it.

Support

Free to use, and always will be. If this helped you out, you can buy me a coffee:

Support me on Ko-fi

License

Copyright (c) 2026 Jared Rhodenizer.

Licensed under the GNU Affero General Public License, version 3 or later (AGPL-3.0-or-later). Use it in your business, commercially, for free. Run it, change it, build your workflow on top of it, and charge for the work you do with it. The one rule is that it stays open: if you hand it to someone else, or run a modified version as a service other people use, your version ships under this same license with its source available. Credit me when you build on it. Want it inside a closed-source commercial product? Email [email protected]. Full terms are in the LICENSE file and at https://www.gnu.org/licenses/agpl-3.0.html

fullstack-agent (jaredrhod/fullstack-agent)

Searching Database…

这是什么?它是一个安装器,在你的机器上组装出一套完整的 AI 智能体配置,把记忆、语音、可视化面孔和可选的手部跟踪控制打包进一次引导式的 Claude Code 对话。
这是智能体框架,还是只是安装向导?它不是供你编写代码的框架;它是在 Claude Code 内运行的设置向导,把四个独立的开源仓库(记忆、语音、面孔、手部)连接成一个可用的智能体。
我需要 Claude 订阅或其他东西吗?需要。你需要带 Claude 订阅的 Claude Code(20 美元的 Pro 套餐就够);Mac/Linux 还需要 git(首次使用时自动安装),Windows 则无需额外准备,因为安装器会自己设置 git。
语音或手部功能有什么坑吗?语音部分需要麦克风,首次运行还需要约 1GB 的本地模型;手部功能需要网络摄像头和 Chrome;在 Windows 上,系统的 'python' 是 Microsoft Store 的占位符,会静默失败,因此这些部分依靠 run.bat 来找到真正的解释器。
它实际支持哪些平台?它可在 macOS、Linux 和 Windows 上工作,其中 Windows 因为缺少内置的 git 和 Python 而需要额外处理。
我智能体的记忆和数据会留在本地吗?会。记忆系统是你机器上的纯文本文件,由你的 AI 读写;你的笔记/vault 位置保持原样,不会被挪进这些代码仓库。
安装完成后会怎样?安装器会留下三个以你的智能体命名的桌面快捷方式:Chat 用于键盘输入的终端会话,Talk 用于语音加可视化面孔,Barehands 用于语音加手部跟踪控制。
如果我已经搭好自己的记忆库或语音配置怎么办?向导会检测并原样采纳你现有的身份和 vault;手工编写的语音或可视化代码会被维护中的仓库版本替换(你的旧文件保留在磁盘上,不会删除),任何自定义可视化场景则会被提升进画廊。
以后我该怎么更新这一切?在 macOS/Linux 上运行 ./fullstack-agent/update.sh,或在 Windows 上直接让智能体 'update everything and tell me what changed';你的个人文件位于仓库之外,因此更新绝不会影响智能体的身份或它记住的内容。
构成这套技术栈的四个部分是什么?ai-memory-vault 提供持久的文本记忆,backtalk 提供按键说话的语音对话,ai-visualizer 提供与语音同步反应的动画面孔,可选的 barehands 则提供基于网络摄像头的手势控制。
What are similar projects?leon, Dodaios, openclaw, LifeOS, claude-code, khoj, taskuary, fyagent
Creator
jaredrhod
Size
0.1 MB
Stars
1.1K
Updated
CommitAug 30
Age
2mo
Commits · 90 Days