animaworks/.env.example at main · xuiltul/animaworks · GitHub

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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
# AnimaWorks Environment Configuration
#
# Copy this file to .env and fill in the values you need.
#
#   cp .env.example .env
#
# Mode A1 (Claude Code) requires NO API keys here.
# Claude Code handles authentication on its own.
# Only configure keys below for features you want to use.

# ── LLM Providers ─────────────────────────────────────────

# Required for Mode A1 Fallback / A2 (when not using Claude Code)
# Get yours at: https://console.anthropic.com/
# ANTHROPIC_API_KEY=sk-ant-...

# Optional: Multi-provider support via LiteLLM (Mode A2)
# Mode C / Codex can also use local `codex login` without this key.
# https://platform.openai.com/api-keys
# OPENAI_API_KEY=sk-...

# https://aistudio.google.com/apikey
# GOOGLE_API_KEY=AI...

# ── Image Generation (Optional) ──────────────────────────
# Character portraits and 3D models for the Web UI.
# Without these, Animas work fine — they just won't have visual avatars.

# Anime-style character art (recommended)
# https://novelai.net/ → Settings > Account > Get Persistent API Token
# NOVELAI_API_TOKEN=pst-...

# Flux image generation
# https://fal.ai/dashboard/keys
# FAL_KEY=...

# 3D character models for the Workspace
# https://www.meshy.ai/ → Dashboard > API Keys
# MESHY_API_KEY=...

# ── External Messaging — Slack (Per-Anima Bots) ──────────
# Each Anima gets its own Slack app (1:1 mapping).
# Create one app per Anima at https://api.slack.com/apps
# Enable Socket Mode and add bot scopes: chat:write,
# channels:history, groups:history, im:history, mpim:history,
# users:read, app_mentions:read.
# See docs/slack-socket-mode-setup.md for full instructions.
#
# Per-Anima bots — add one pair per Anima:
# SLACK_BOT_TOKEN__sakura=xoxb-...
# SLACK_APP_TOKEN__sakura=xapp-...
#
# SLACK_BOT_TOKEN__sumire=xoxb-...
# SLACK_APP_TOKEN__sumire=xapp-...
#
# New slots are auto-appended to .env when an Anima is registered.
#
# Shared bot (fallback, optional):
# SLACK_BOT_TOKEN=xoxb-...
# SLACK_APP_TOKEN=xapp-...

# Chatwork integration
# https://www.chatwork.com/ → Settings > API Token
# CHATWORK_API_TOKEN=...

# ── Local LLM (Optional) ─────────────────────────────────

# Ollama server address(es) for Mode B
# OLLAMA_SERVERS=http://localhost:11434

# ── Anima Icon URL (Optional) ─────────────────────────────
# Template URL for Anima avatars shown in Slack/Chatwork messages.
# {name} is replaced with the Anima name.
# Examples: GitHub public repo, CDN, or self-hosted.
# ICON_URL_TEMPLATE=https://raw.githubusercontent.com/you/repo/main/assets/icons/{name}.png
#
# You can also set this in config.json as "icon_url_template",
# or per-Anima in status.json as "icon_url" (absolute URL).

# ── Runtime (Optional) ───────────────────────────────────

# Override the default runtime data directory
# ANIMAWORKS_DATA_DIR=~/.animaworks