Skip to content

quachphu/NeuroFlow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NeuroFlow

A multi-agent study companion for neurodivergent students, built with Fetch.ai's uAgent framework and ASI-1 Mini.

What It Does

NeuroFlow adapts to how your brain works. It connects your calendar, course assignments, and disability profile to create personalized study plans with smart scheduling.

Agent Role
Orchestrator Classifies intent and routes queries through the agent chain
Advisor Researches disability-specific study strategies using live web search
Focus Builds adapted focus sessions (duration, breaks, techniques)
Calendar Finds optimal study slots based on your actual class schedule

How It Works

  1. User sends a message (e.g., "help me study for my AI midterm")
  2. Orchestrator classifies intent → triggers agent chain
  3. Advisor researches strategies for the student's disability
  4. Focus builds an adapted session plan
  5. Calendar finds open slots around existing classes
  6. Response is synthesized and returned with proposed time slots

Tech Stack

Backend: Python, FastAPI, Fetch.ai uAgents, ASI-1 Mini Frontend: React 19, Vite, Tailwind CSS Integrations: Google Calendar API, Canvas LMS, DuckDuckGo Search Protocols: Agentverse mailbox, MCP, DeltaV chat protocol

Getting Started

# Clone and install
git clone https://github.com/your-repo/AccessOrchestra.git
cd AccessOrchestra
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

# Set environment variables
cp .env.example .env
# Fill in: ASI1_API_KEY, ORCHESTRATOR_SEED, ADVISOR_SEED, FOCUS_SEED, CALENDAR_SEED

# Start agents
python -m agents.advisor_agent.advisor_agent &
python -m agents.focus_agent.focus_agent &
python -m agents.calendar_agent.calendar_agent &
python -m agents.orchestrator.orchestrator_agent &

# Start server
python server.py

# Frontend
cd frontend && npm install && npm run dev

Open http://localhost:8080 to use the app.


Built at BeachHacks 2025

About

BeachHacks 9.0

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors