Nx monorepo for an enterprise multi-agent stack: Angular studio UI, NestJS API gateway, shared developer CLI, and a Python FastAPI / LangGraph agent core.

enterprise-ai-workspace/
├── apps/
│   ├── client/             # Angular 17+ Studio UI
│   └── gateway-server/     # NestJS API Gateway (JWT, Kafka, proxy)
├── libs/
│   └── ai-cli/             # Shared developer CLI library
├── agent-core/             # Python FastAPI + LangGraph engine
├── docker-compose.yml      # Full-stack Docker orchestration
├── package.json            # Single Node.js dependency root
├── nx.json
├── workspace.json
└── tsconfig.base.json

Angular Client  →  NestJS Gateway (:3000)  →  Python Agent Core (:8000)
                         ↓
                      Kafka events

• Node.js 20+
• npm 10+
• Python 3.11+
• Git
• Optional: MongoDB (localhost:27017), Kafka (localhost:9092), OpenAI + Pinecone API keys

git clone <your-repo-url> enterprise-ai-workspace
cd enterprise-ai-workspace
npm install

Copy the example env files and fill in real values:

# Windows PowerShell
Copy-Item agent-core\.env.example agent-core\.env
Copy-Item apps\gateway-server\.env.example apps\gateway-server\.env

# macOS / Linux
cp agent-core/.env.example agent-core/.env
cp apps/gateway-server/.env.example apps/gateway-server/.env

Never commit .env files. Only .env.example files are tracked.

cd agent-core
python -m venv .venv

# Windows
.\.venv\Scripts\Activate.ps1

# macOS / Linux
source .venv/bin/activate

pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

From the workspace root (another terminal):

npm run start:gateway
# or
npx nx serve gateway-server

Gateway listens on http://localhost:3000.

From the workspace root (another terminal):

npm run start:client
# or
npx nx serve client

Client listens on http://localhost:4200 and posts prompts to:

http://localhost:3000/api/v1/gateway/agent/dispatch

See:

• agent-core/.env.example
• apps/gateway-server/.env.example

• Standalone components
• AgentTerminalComponent for real-time prompt/console UX
• AiGatewayService RxJS HTTP client to the Nest gateway

• Domain modules: auth, ai-gateway, events
• JWT strategy + guard
• Proxies validated prompts to Python agent-core
• Kafka producer/consumer for gateway events (degrades gracefully if Kafka is down)

• FastAPI entrypoint (app/main.py)
• LangGraph workflow (app/graph.py)
• RAG / LlamaIndex + Pinecone service (app/service.py)
• Settings via python-dotenv + pydantic (app/config.py)

• Shared Commander-based CLI helpers
• Path alias: @enterprise-ai/ai-cli

Prerequisites: Docker Desktop with Compose v2.

1. Ensure env files exist and contain real keys:

Copy-Item agent-core\.env.example agent-core\.env
Copy-Item apps\gateway-server\.env.example apps\gateway-server\.env

2. Build and start the full stack:

docker compose up --build -d
# or
npm run docker:up

3. Open:

4. Useful commands:

npm run docker:ps      # container status
npm run docker:logs    # follow logs
npm run docker:down    # stop stack
docker compose up --build agent-core gateway-server   # subset only

Compose wires internal networking automatically:

• Gateway → http://agent-core:8000/api/v1/agent/chat
• Gateway → mongodb://mongo:27017/enterprise-ai
• Gateway → kafka:29092

1. Copy both .env.example files to .env
2. Set OpenAI / Pinecone keys in agent-core/.env
3. Set a strong JWT_SECRET in apps/gateway-server/.env
4. Confirm AI_CORE_URL=http://localhost:8000/api/v1/agent/chat
5. Start agent-core → gateway → client (in that order)
6. Open the studio UI and submit a prompt

GitHub Actions workflows:

• .github/workflows/ci-pipeline.yml — Node/Python build checks
• .github/workflows/docker.yml — Compose validate + image builds

Jobs (app CI):

1. gateway-validation — npm ci + nx build gateway-server
2. ai-core-validation — install Python deps + flake8 syntax checks
3. client-validation — npm ci + nx build client

• .env files are gitignored
• Do not commit API keys, JWT secrets, or connection strings
• Rotate any secrets that were previously committed or shared
• Prefer short-lived tokens and least-privilege cloud keys in production

UNLICENSED / private repository.