Skip to content

briancatmaster/Open-Advisor

Repository files navigation

OpenAdvisor — UMich AI Degree Advisor

AI-powered academic planning for University of Michigan students. Upload your degree audit, set your career goals, and get a personalized course pathway with a built-in AI advisor.


Setup

1. Install dependencies

npm install

2. Add your API key

Open .env.local and fill in your OpenRouter key:

OPENROUTER_API_KEY=sk-or-...
DEFAULT_MODEL=openai/gpt-4o-mini

To swap models later, just change DEFAULT_MODEL — no code changes needed. Any model on openrouter.ai/models works.

3. Run the dev server

npm run dev

Open http://localhost:3000.


App Flow

Step URL What happens
1 / Landing page
2 /upload Upload your degree audit PDF (Wolverine Access → Student Records → Degree Audit → Save as PDF)
3 /profile Enter year, major, home school/program, career goal, AP/transfer credits
4 /dashboard Course recommendations + semester planner + AI advisor

Course Database

The app now uses a single curated source:

  • courses_master.db (Atlas-style schema from data mining pipeline)

Normalized API rows now also include:

source, atlas_url, prereq_hard_codes, prereq_advisory_text, top_degrees

Project Structure

app/
  page.tsx              # Landing
  upload/page.tsx       # Audit upload
  profile/page.tsx      # Profile builder
  dashboard/page.tsx    # Main 3-panel dashboard
  api/
    parse-audit/        # POST: PDF → course list
    courses/            # GET: search + ranked recommendations
    advise/             # POST: streaming chat (OpenRouter)

lib/
  claude.ts             # OpenRouter client + system prompt builder
  store.ts              # Zustand global state
  audit-parser.ts       # PDF → taken/remaining courses
  course-ranker.ts      # Scoring algorithm
  db.ts                 # SQLite (better-sqlite3)
  types.ts              # Shared TypeScript interfaces

courses_master.db       # Curated Atlas-style source used by app/runtime
schema.md               # Human-readable schema reference for agent context

Build

npm run build
npm start

About

The best AI-enhanced course advisor in AA. Chat with an AI that knows every course, every prerequisite, and how to advance your future career.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages