Downloads ยท 30 days
0
sp103107/NERA
NERA is a machine learning model from sp103107. Use it for the machine learning task on the model card, and read the license before you ship it in a product.
[](https://www.python.org/downloads/) [](https://streamlit.io/) [](https://ai.google.dev/) [](LICENSE)
Downloads ยท 30 days
0
Access
Public
Updated Aug 2, 2025
Repo size
โ
Likes
0
Public
Click a slice to open those files.
.pyc28.8 KB ยท 45%
From the Hugging Face model README
AI-Powered Admissions Assistant for Northeastern University
NORA is an intelligent admissions evaluation system that uses Google Gemini AI to analyze student applications, score them across multiple criteria, and provide detailed rankings with explanations.
Try NORA online: Hugging Face Space
NORA/
โโโ agent/ # Core AI agent logic
โ โโโ admissions_agent.py # Main agent class
โ โโโ prompts.py # AI prompt engineering
โ โโโ utils.py # Utility functions
โโโ ui/ # User interface
โ โโโ streamlit_app.py # Streamlit web application
โโโ tests/ # Comprehensive test suite
โ โโโ test_agent.py # Agent unit tests
โ โโโ test_integration.py # Integration tests
โ โโโ test_performance.py # Performance tests
โ โโโ test_ui.py # UI component tests
โ โโโ mocks.py # Mock data and responses
โโโ data/ # Sample data
โ โโโ sample_applications.json
โ โโโ rubric.json
โโโ docs/ # Documentation
โโโ DEMO_README.md
โโโ UI_DEMO_GUIDE.md
โโโ ROADMAP_SUMMARY.md
Clone the repository
git clone https://github.com/sp103107/NORA.git
cd NORA
Install dependencies
pip install -r requirements.txt
Set up your API key
# Windows PowerShell
$env:GOOGLE_API_KEY = "your-api-key-here"
# Linux/Mac
export GOOGLE_API_KEY="your-api-key-here"
Run the application
# CLI version
python app.py
# Web UI
python -m streamlit run ui/streamlit_app.py
Complete demonstration with all 10 sample applicants
Instant demo without API calls
Focused analysis of specific applicants
python run_tests.py
python run_tests.py --quick
# Unit tests
python -m pytest tests/test_agent.py -v
python -m pytest tests/test_utils.py -v
python -m pytest tests/test_ui.py -v
# Integration tests
python -m pytest tests/test_integration.py -v
# Performance tests
python -m pytest tests/test_performance.py -v
GOOGLE_API_KEY: Your Google Gemini API key (required)gemini-1.5-flash (default)NORA evaluates applicants across four weighted criteria:
The application is deployed on Hugging Face Spaces:
# Production setup
pip install -r requirements.txt
streamlit run ui/streamlit_app.py --server.port 8501
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)This project is licensed under the MIT License - see the LICENSE file for details.
๐ NORA Admissions Agent - Northeastern University Powered by Google Gemini AI