agent-dj 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +144 -0
- package/dist/cli.js +274979 -0
- package/dist/server.js +274084 -0
- package/package.json +71 -0
- package/web/dist/assets/index-C_p3GG7h.css +1 -0
- package/web/dist/assets/index-DkpIwp3f.js +348 -0
- package/web/dist/index.html +16 -0
package/README.md
ADDED
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
# Agent DJ
|
|
2
|
+
|
|
3
|
+
Self-hosted AI agent platform with a beautiful dashboard. One command install, multi-agent orchestration, RAG, MCP support.
|
|
4
|
+
|
|
5
|
+
## Quick Start
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
# Install globally
|
|
9
|
+
npm install -g agent-dj
|
|
10
|
+
|
|
11
|
+
# Or run directly with npx
|
|
12
|
+
npx agent-dj
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
On first run, the setup wizard walks you through choosing a provider and entering your API key. Then the dashboard opens automatically.
|
|
16
|
+
|
|
17
|
+
## Features
|
|
18
|
+
|
|
19
|
+
- Multi-agent orchestration (Coder, Researcher, Writer, System, RAG)
|
|
20
|
+
- Chat interface with conversation history
|
|
21
|
+
- Memory system (user context, feedback, projects)
|
|
22
|
+
- Knowledge base with RAG (document upload, hybrid search)
|
|
23
|
+
- MCP (Model Context Protocol) server support
|
|
24
|
+
- Permission system for file/command access
|
|
25
|
+
- Audit log for all agent actions
|
|
26
|
+
- Beautiful dashboard UI (React + Tailwind)
|
|
27
|
+
|
|
28
|
+
## Supported Providers
|
|
29
|
+
|
|
30
|
+
| Provider | Auth | Notes |
|
|
31
|
+
|----------|------|-------|
|
|
32
|
+
| **Anthropic** | API key or OAuth token | Claude Opus, Sonnet, Haiku |
|
|
33
|
+
| **OpenAI** | API key | GPT-4o, o1, o3-mini |
|
|
34
|
+
| **Google** | API key | Gemini 2.0 Flash/Pro |
|
|
35
|
+
| **Groq** | API key | Llama 3.3 70B (fast, free tier) |
|
|
36
|
+
| **Ollama** | None | Local models, free |
|
|
37
|
+
|
|
38
|
+
## Setup & Authentication
|
|
39
|
+
|
|
40
|
+
### Option A: API Key (any provider)
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
agent-dj setup
|
|
44
|
+
# Choose provider → paste API key → pick model → done
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Option B: Anthropic Max/Pro OAuth Token
|
|
48
|
+
|
|
49
|
+
Use your existing Claude Max or Pro subscription — no API credits needed.
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# 1. Install Claude Code CLI and login
|
|
53
|
+
npm install -g @anthropic-ai/claude-code
|
|
54
|
+
claude login
|
|
55
|
+
|
|
56
|
+
# 2. Run setup — auto-detects your OAuth token
|
|
57
|
+
agent-dj setup
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## Commands
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
agent-dj # Setup (if needed) + start server
|
|
64
|
+
agent-dj setup # Interactive setup wizard
|
|
65
|
+
agent-dj start # Start server + dashboard
|
|
66
|
+
agent-dj start -p 8080 # Custom port
|
|
67
|
+
agent-dj config # Show current configuration
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Dashboard: **http://localhost:3456**
|
|
71
|
+
|
|
72
|
+
## Local Development
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
git clone https://github.com/Djumabaevs/action-agent.git
|
|
76
|
+
cd action-agent
|
|
77
|
+
npm install
|
|
78
|
+
cd web && npm install && cd ..
|
|
79
|
+
|
|
80
|
+
# Dev mode (server with watch)
|
|
81
|
+
npx tsx src/cli/index.ts start
|
|
82
|
+
|
|
83
|
+
# Build
|
|
84
|
+
npm run build
|
|
85
|
+
|
|
86
|
+
# Run tests
|
|
87
|
+
npm test
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## MCP Integration
|
|
91
|
+
|
|
92
|
+
Connect external MCP servers via the dashboard (Settings > MCP Servers) or config file at `~/.agent-dj/config.json`:
|
|
93
|
+
|
|
94
|
+
```json
|
|
95
|
+
{
|
|
96
|
+
"mcpServers": [
|
|
97
|
+
{
|
|
98
|
+
"id": "my-server",
|
|
99
|
+
"name": "My MCP Server",
|
|
100
|
+
"command": "npx",
|
|
101
|
+
"args": ["-y", "@my-org/my-mcp-server"]
|
|
102
|
+
}
|
|
103
|
+
]
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
Connected MCP tools are automatically available to all agents.
|
|
108
|
+
|
|
109
|
+
## Knowledge Base (RAG)
|
|
110
|
+
|
|
111
|
+
Upload documents via the dashboard Knowledge page or use the chat:
|
|
112
|
+
|
|
113
|
+
- "search knowledge base for deployment guide"
|
|
114
|
+
- "ingest this document into the knowledge base"
|
|
115
|
+
|
|
116
|
+
Supports: plain text, markdown, code files, PDF, DOCX.
|
|
117
|
+
|
|
118
|
+
## Project Structure
|
|
119
|
+
|
|
120
|
+
```
|
|
121
|
+
agent-dj/
|
|
122
|
+
├── src/
|
|
123
|
+
│ ├── cli/ # CLI commands (setup, start)
|
|
124
|
+
│ ├── llm/ # LLM provider integration
|
|
125
|
+
│ ├── agent/ # Agent definitions & orchestrator
|
|
126
|
+
│ ├── server/ # Hono API server & routes
|
|
127
|
+
│ ├── db/ # SQLite database
|
|
128
|
+
│ ├── memory/ # Memory system
|
|
129
|
+
│ ├── rag/ # RAG (knowledge base)
|
|
130
|
+
│ ├── mcp/ # MCP client/server
|
|
131
|
+
│ ├── tools/ # Built-in tools (file, shell, web)
|
|
132
|
+
│ └── permissions/ # Permission management
|
|
133
|
+
├── web/ # React dashboard (Vite + Tailwind)
|
|
134
|
+
├── tests/ # Test suite (vitest)
|
|
135
|
+
└── package.json
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
## Configuration
|
|
139
|
+
|
|
140
|
+
Config stored at `~/.agent-dj/config.json`. Data (SQLite DB, memory, knowledge) stored in `~/.agent-dj/`.
|
|
141
|
+
|
|
142
|
+
## License
|
|
143
|
+
|
|
144
|
+
Apache-2.0
|