zeph 0.18.3

Lightweight AI agent with hybrid inference, skills-first architecture, and multi-channel I/O
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

# First Conversation

This guide takes you from a fresh install to your first productive interaction with Zeph.

## Prerequisites

- Zeph [installed](installation.md) and `zeph init` completed
- Either Ollama running locally (`ollama serve`), or a Claude/OpenAI API key configured

## Start the Agent

```bash
zeph
```

You see a `You:` prompt. Type a message and press Enter.

## Ask About Files

```
You: What files are in the current directory?
```

Behind the scenes:
1. Zeph embeds your query and matches the `file-ops` skill (ranked by cosine similarity)
2. The skill's instructions are injected into the prompt
3. The agent calls the `list_directory` or `find_path` tool to list files
4. You get a structured answer with the directory listing

You did not tell Zeph which skill to use — it figured it out from context.

## Run a Command

```
You: Check disk usage on this machine
```

Zeph matches the `system-info` skill and runs `df -h` via the `bash` tool. If a command is potentially destructive (like `rm` or `git push --force`), Zeph asks for confirmation first:

```
Execute: rm -rf /tmp/old-cache? [y/N]
```

## See Memory in Action

```
You: What files did we just look at?
```

Zeph remembers the full conversation. It answers from context without re-running any commands. With [semantic memory](../guides/semantic-memory.md) enabled (Qdrant), Zeph can also recall relevant context from past sessions.

## Useful Slash Commands

| Command | Description |
|---------|-------------|
| `/skills` | Show active skills and usage statistics |
| `/mcp` | List connected MCP tool servers |
| `/reset` | Clear conversation context |
| `/image <path>` | Attach an image for visual analysis |

Type `exit`, `quit`, or press Ctrl-D to stop the agent.

## Next Steps

- [Configuration Wizard](wizard.md) — customize providers, memory, and channels
- [Configuration Recipes](../guides/config-recipes.md) — copy-paste configs for common setups (local, cloud, hybrid, coding assistant, Telegram bot)
- [Skills](../concepts/skills.md) — understand how skill matching works
- [Tools](../concepts/tools.md) — what the agent can do with shell, files, and web