Repolode
vercel-labs

vercel-labs/personal-agent-template

A forkable Nuxt and Eve template for a self-hosted personal AI agent with web chat, Slack, GitHub, Linear, and persistent memory.

Stars
477
Forks
78
Open issues
3
Last commit
2 months ago

What is it?

Personal Agent Template is a starting point for building your own always-on AI assistant. It runs a chat interface in the browser and connects the same agent to Slack DMs and mentions, so conversations and context carry across surfaces. The agent can query GitHub repositories, pull requests, issues and workflows, and Linear issues, projects and cycles, with write operations gated by durable approval.

The project pairs a Nuxt web app (with Nitro API, Better Auth email/password sign-in, and PostgreSQL) with an Eve agent runtime. Threads persist across sessions because Eve holds the transcript. Long-term memory is a bounded, model-maintained document per user, stored in private Vercel Blob storage; the agent recalls it before each turn and saves or removes entries when a conversation calls for it. A morning-briefing skill summarizes recalled focus areas and assigned Linear issues.

The template is MIT licensed and designed to be forked and renamed. It ships with a persona called V, and a customization guide covers the agent's name, model, tools, skills, integrations and UI theme. It can be deployed to Vercel with one click or self-hosted with Node.js 24+ and pnpm.

Key features

  • 01Browser chat with threads that resume across sessions and tool calls shown in real time.
  • 02Slack DMs and @mentions routed to the same agent, with accounts linked to a web profile.
  • 03GitHub and Linear tools via Vercel Connect, with approval required for writes.
  • 04Persistent per-user memory that is recalled before each turn and editable by the agent.
  • 05Morning-briefing skill built from recalled memory and assigned Linear issues.
  • 06One-click Vercel deploy or local self-hosting with Better Auth and PostgreSQL.

Use cases

  • Building a personal assistant that you host and control on your own Vercel or Node.js infrastructure.
  • Querying GitHub pull requests and Linear issues from a chat interface or Slack.
  • Starting point for a custom agent with its own persona, tools and memory.
  • Exploring how Eve, Nuxt and Better Auth fit together in an agent application.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/vercel-labs/personal-agent-template.git
  2. 2

    Change into the project directory

    cd personal-agent-template
  3. 3

    Install dependencies, copy the env file, and run database migrations

    pnpm install && cp .env.example .env && pnpm db:migrate
  4. 4

    Start the dev server and open localhost:3000

    pnpm dev

Things to know

  • Requires Node.js 24+ and pnpm, plus environment variables such as BETTER_AUTH_SECRET and INTERNAL_API_SECRET.
  • Persistent memory needs a private Vercel Blob store attached to the project before deploying.
  • GitHub and Linear integrations rely on Vercel Connect, which adds setup overhead.

Topics

FAQ

What is personal-agent-template?
A forkable Nuxt and Eve template for a self-hosted personal AI agent with web chat, Slack, GitHub, Linear, and persistent memory. Personal Agent Template is a starting point for building your own always-on AI assistant. It runs a chat interface in the browser and connects the same agent to Slack DMs and mentions, so conversations and context carry across surfaces. The agent can query GitHub repositories, pull requests, issues and workflows, and Linear issues, projects and cycles, with write operations gated by durable approval.
Is personal-agent-template free to use? What license does it have?
personal-agent-template is open source under the MIT license. Check the license terms before using it in commercial products.
Is personal-agent-template still maintained?
Updated within 6 months. The last commit to personal-agent-template was on Sep 2, 2026.
What can I use personal-agent-template for?
Building a personal assistant that you host and control on your own Vercel or Node.js infrastructure. Querying GitHub pull requests and Linear issues from a chat interface or Slack. Starting point for a custom agent with its own persona, tools and memory. Exploring how Eve, Nuxt and Better Auth fit together in an agent application.
How do I install personal-agent-template?
Clone the repository: git clone https://github.com/vercel-labs/personal-agent-template.git Change into the project directory: cd personal-agent-template Install dependencies, copy the env file, and run database migrations: pnpm install && cp .env.example .env && pnpm db:migrate Start the dev server and open localhost:3000: pnpm dev
Where can I get personal-agent-template?
The source code and installation instructions are on GitHub: https://github.com/vercel-labs/personal-agent-template

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects