Quick Start

Get AgentLife running on your infrastructure in 15 minutes.

1. Install Hermes Agent

AgentLife runs on Hermes Agent. If you don't have it installed:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

After install, configure a model provider:

hermes setup model

Verify everything works:

hermes doctor

2. Install the AgentLife Framework

Clone the framework repo:

git clone https://github.com/agentlife1/agentlife.git ~/agentlife
cd ~/agentlife/framework
pip install -e .

Verify the CLI works:

agentlife pack list

3. Choose a Persona

Browse available persona packs:

agentlife pack list

Get details on a specific persona:

agentlife pack info life-ops

Seven personas are available:

Persona	Description	Best For
Life Ops	Portfolio, expenses, calendar, subscriptions	Personal finance & life management
Enterprise Architect	Architecture, cloud, governance, tech radar	Solution architects & tech leaders
Knowledge Worker	Research, writing, analysis, knowledge base	Information professionals & analysts
Hobbyist	Projects, sourcing, skills, making	Makers, crafters & DIY enthusiasts
Small Biz Owner	Ops, CRM, finance, marketing	Entrepreneurs & solo business owners
Student	Courses, study plans, research, assignments	Students managing academic life
Indie Hacker	Product, growth, research, ops	Solo founders & indie developers

4. Export and Install a Persona Pack

Export a pack as a portable SKILL.md bundle:

agentlife pack export life-ops

This generates life-ops-pack.md in your current directory. Copy it to your Hermes skills folder:

mkdir -p ~/.hermes/skills/life-ops
cp life-ops-pack.md ~/.hermes/skills/life-ops/SKILL.md

For a ZIP bundle with scripts and use cases:

agentlife pack export life-ops --format zip

5. Configure Cron Jobs

Each persona comes with pre-configured cron schedules. Set them up in your Hermes config:

# Example: Life Ops daily brief (weekdays at 7 AM)
hermes cron create "0 7 * * 1-5" \
  --name "life-ops-brief" \
  --prompt "Run the Life Ops morning brief. Check portfolio, expenses, calendar, subscriptions."

6. Configure MCP Servers (Optional)

Each persona recommends specific MCP servers for live tool access. Start with the basics:

# Filesystem access for documents
hermes mcp add filesystem \
  --command "npx -y @modelcontextprotocol/server-filesystem /home/YOU/agentlife"

# Web search for research
hermes mcp add web_search \
  --command "npx -y tavily-mcp" \
  --env TAVILY_API_KEY="your-key-here"

Pro tip: Start with one persona and one MCP server. Add more as you get comfortable. See the Persona Packs page for full details on each persona's recommended servers.

7. Multi-Agent Coordination (Optional)

Use the mesh feature to coordinate multiple persona agents:

# Initialize a coordination session
agentlife mesh init life-ops-session \
  --topic "Weekly Life Review" \
  --personas life-ops

# Join with an agent
agentlife mesh join life-ops-session

# Check session status
agentlife mesh status life-ops-session

Next Steps

Read the Persona Packs guide for detailed capability breakdowns
Explore the Architecture docs to understand the three-tier model
Browse the CLI Reference for all available commands
Configure MCP servers for full live tool access

Getting Started

Personas

Reference