How kpuneethharshanaik/neuroagent works
NeuroAgent accepts an event-marked EEG recording, processes it through validation, signal preparation, prediction, policy decision, and report stages, then keeps the human review distinct from the automated verdict. The React workspace uploads and tracks jobs, presents evidence and signal previews, and records reviews; a public landing page is also served. The README documents both an in-process pipeline and optional step-wise n8n orchestration. The map uses documented responsibilities and sampled wiring; unsampled implementation details are not inferred.
Main entry points: Tool.tsx Review workspace · useLiveJob.ts Live job tracking · main.py FastAPI routes · agents.py Stage agents
Components 22
API and orchestration
- FastAPI routes
backend/main.py - Job records
backend/main.py
Review pipeline
- Stage agents
backend/agents.py - Pipeline graph
backend/graph.py - EEG processing
backend/eeg.py - Evidence checks
backend/evidence.py - FBCNet inference
backend/inference.py - Deterministic policy
backend/policy.py - Review recording
backend/feedback.py - Job and report types
backend/schemas.py
Review workspace
- Review workspace
web/src/tool/Tool.tsx - Live job tracking
web/src/tool/useLiveJob.ts - API client
web/src/lib/api.ts - Upload panel
web/src/tool/UploadPanel.tsx - Pipeline view
web/src/tool/PipelinePanel.tsx - Evidence panel
web/src/tool/EvidencePanel.tsx - Signal lens
web/src/tool/SignalLens.tsx - Review brief
web/src/tool/ReviewBrief.tsx
Public site
- Landing experience
web/src/landing/Landing.tsx
Other components
- EEG submitter
- Human reviewer
- n8n orchestrator
Connections 30
- EEG submitter → Upload panel: selects recording
- Upload panel → Review workspace: submits file
- Review workspace → Live job tracking: starts or resumes
- Live job tracking → API client: requests job
- API client → FastAPI routes: calls routes
- FastAPI routes → Job records: stores job state
- FastAPI routes → Pipeline graph: runs pipeline
- FastAPI routes → n8n orchestrator: hands off optionally
- n8n orchestrator → FastAPI routes: calls step routes
- Pipeline graph → Stage agents: dispatches stages
- Stage agents → EEG processing: processes recording
- Stage agents → Evidence checks: checks evidence
- Stage agents → FBCNet inference: classifies trials
- Stage agents → Deterministic policy: evaluates gates
- Pipeline graph → Job and report types: produces report
- FastAPI routes → Review recording: records review
- Review workspace → Upload panel: renders
- Review workspace → Pipeline view: renders
- Review workspace → Evidence panel: renders
- Review workspace → Signal lens: renders
- Review workspace → Review brief: renders
- Live job tracking → Pipeline view: supplies updates
- Live job tracking → Evidence panel: supplies updates
- Live job tracking → Signal lens: supplies job
- Live job tracking → Review brief: supplies report
- Signal lens → API client: requests preview
- Review brief → Human reviewer: presents verdict
- Human reviewer → Review brief: submits decision
- Review brief → API client: records review
- Landing experience → EEG submitter: offers workspace