Getting Started

Prerequisites

Node.js 20+
MongoDB instance
Norman Engine running (default: http://localhost:3001)

Installation

git clone https://github.com/ShellTechnology/norman-agent.git
cd norman-agent
npm install

Configuration

cp .env.example .env

PORT=3004
MONGODB_URI=mongodb://localhost:27017/norman-agent
NORMAN_ENGINE_URL=http://localhost:3001
AGENT_MODE=v0.1  # or v1 for task agent

Development

npm run dev

Quick Test

# Chat with the agent
curl -X POST http://localhost:3004/api/chat \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "What can you do?"}],
    "userId": "test-user",
    "chatId": "test-chat"
  }'
 
# List available tools
curl http://localhost:3004/api/tools
 
# Store a memory
curl -X POST http://localhost:3004/api/memory \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "test-user",
    "type": "long_term",
    "content": "User prefers concise answers"
  }'

Architecture Configuration