# Hope Agent User Guide

Canonical page: https://www.hopeagent.ai/en/guide

New users should read the first three chapters in order. For a specific capability or setting, jump straight to the relevant chapter. The guide is maintained alongside the product.

## 01. Getting Started

Installation, first launch, three run modes, auto-update, and one-click local models.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/01-getting-started.md)

## 02. Models & Providers

Providers, API keys, primary/fallback models, media generation, speech-to-text, and web search.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/02-models-and-providers.md)

## 03. Chat & Sessions

Chat UI, multimodal attachments, session references and Codex history import, incognito mode, context compaction, and slash commands.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/03-chat-and-sessions.md)

## 04. Memory

Three memory tiers, auto-memory, recall, Dreaming, user profile, and correction loop.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/04-memory.md)

## 05. Knowledge Space

A Markdown second brain with Obsidian, full-text/vector search, backlinks, graph, and AI chat.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/05-knowledge-space.md)

## 06. Design Space

Generate 10+ artifact types with live preview, editing, versions, export, and code handoff.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/06-design-space.md)

## 07. Tools & Permissions

Built-in tools, three permission modes, approvals, protected paths, Docker sandbox, and computer control.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/07-tools-and-permissions.md)

## 08. Autonomous Tasks

Goal, Workflow, Loop, Plan Mode, Task, and execution modes.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/08-autonomous-tasks.md)

## 09. Multi-Agent & Scheduling

Sub-agents, teams, natural-language schedules, background jobs, and self-wakeup.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/09-multi-agent-and-scheduling.md)

## 10. IM Channels

Telegram, Discord, Slack, Feishu/Lark, multimodal input, approvals, streaming, and handoff.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/10-im-channels.md)

## 11. Connect & Extend

MCP client/platform server, lifecycle Hooks, and the skill system.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/11-connect-and-extend.md)

## 12. Projects & Insights

Project containers, Agent config, Dashboard cost/health, and Recap.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/12-projects-and-insights.md)

## 13. Settings & Security

Settings navigation, conversational configuration, backup/rollback, security, and reliability.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/13-settings-and-security.md)

## 14. Capability Evaluation

Evaluate Goal, Workflow, asynchronous tasks, and multi-agent scenarios with real models.

[Read chapter](https://github.com/shiwenwen/hope-agent/blob/main/docs/user-guide/en/14-capability-evaluation.md)

## Documentation and source

- [Hope Agent — Open-source AI assistant with memory and tools](https://www.hopeagent.ai/en)

- [Install Hope Agent](https://www.hopeagent.ai/en/install)

- [Running modes](https://www.hopeagent.ai/en/running-modes)

- [Features](https://www.hopeagent.ai/en/features)

- [Self-Hosting](https://www.hopeagent.ai/en/self-host)

- [Frequently asked questions](https://www.hopeagent.ai/en/faq)

- [What's new](https://www.hopeagent.ai/en/changelog)

- [GitHub](https://github.com/shiwenwen/hope-agent)

- [Releases](https://github.com/shiwenwen/hope-agent/releases)

- [MIT](https://github.com/shiwenwen/hope-agent/blob/main/LICENSE)