How intrusive-thots/james-linux works
JAMES is a Linux wireless-security operations application with a PyQt desktop client, FastAPI/WebSocket backend, and React web client. Users inspect wireless networks, select targets, run authorized assessment actions, monitor capture or cracking progress, and review logs and results; an AI agent and autopilot provide additional action and workflow modes. The orchestrator coordinates execution tools and the native layer, while a separate Wireless SOC API stores sensor observations and tracks approved access points and detections. Arrows reflect documented or indexed references; unsampled subsystem internals and live sensor wiring are not asserted.
Main entry points: orchestrator.py Action orchestrator · agent.py AI agent · App.tsx React workspace · main_window.py Desktop UI
Components 22
User Interfaces
- Desktop UI
james/gui/main_window.py - Desktop workflows
james/gui/tabs - React workspace
web/src/App.tsx - Client state
web/src/hooks/useAppState.ts - WebSocket client
web/src/hooks/useWebSocket.ts - Workspace pages
web/src/pages
API and Coordination
- Application entry
main.py - FastAPI backend
james/api/server.py - Action orchestrator
james/core/orchestrator/orchestrator.py - AI agent
james/core/agent/agent.py - AI engine
james/core/ai_engine.py - Agent primers
james/core/primers.py - Assessment reports
james/core/report.py - Autopilot agent
james/core/auto_agent.py - Wordlist generator
james/wordlists/generator.py
Wireless Assessment
- Native execution
james/layers/native.py - Wi-Fi tools
james/tools/wifi.py - PineAP suite
james/tools/pineap.py - Network guard
james/core/net_guard.py
Wireless SOC
- SOC endpoints
james/api/wireless_soc_routes.py - SOC inventory store
james/api/wireless_soc.py
Other components
- Operator
Connections 22
- Operator → Desktop UI: uses
README.md - Operator → React workspace: uses
README.md - Application entry → Desktop UI: launches
main.py - Application entry → FastAPI backend: starts
main.py - Desktop UI → Action orchestrator: uses
james/gui/main_window.py - Desktop UI → Desktop workflows: hosts
james/gui/main_window.py - React workspace → Workspace pages: renders
web/src/App.tsx - React workspace → WebSocket client: connects
web/src/App.tsx - React workspace → Client state: uses state
web/src/App.tsx - WebSocket client → FastAPI backend: exchanges messages
README.md - FastAPI backend → Action orchestrator: dispatches actions
james/api/server.py - Action orchestrator → Native execution: executes commands
james/core/orchestrator/orchestrator.py - Action orchestrator → Network guard: uses protection
james/core/orchestrator/orchestrator.py - Action orchestrator → PineAP suite: dispatches attacks
james/core/orchestrator/orchestrator.py - Action orchestrator → Wi-Fi tools: uses tools
- Action orchestrator → Wordlist generator: generates lists
james/core/orchestrator/orchestrator.py - AI agent → AI engine: uses
james/core/agent/agent.py - AI agent → Action orchestrator: coordinates actions
james/core/agent/agent.py - AI agent → Agent primers: loads guidance
james/core/agent/agent.py - AI agent → Assessment reports: uses reports
james/core/agent/agent.py - FastAPI backend → SOC endpoints: registers routes
james/api/server.py - SOC endpoints → SOC inventory store: reads and writes
james/api/wireless_soc_routes.py