Holistic AI x UCL Hackathon 2025

Build Production-Grade AI Agents | November 15-16, 2025 | London

$65,000 Prize Pool | 3 Tracks | 2 Days | Production-Ready Agents

Website • Register & Submit (Devpost) • Discord • 📅 Event Schedule • Rules • Judging & Prizes

---

🚀 Quick Start - Get Running in 10 Minutes

Get your first AI agent running quickly. No prior experience needed.

⚡ Fast Track (5 commands)

# 1. Clone repository (with example submodules)
git clone --recursive https://github.com/holistic-ai/hackthon-2025.git && cd hackthon-2025

# 2. Install dependencies
pip install -r requirements.txt

# 3. Configure environment
cp .env.example .env
# Edit .env with your API keys (see below)

# 4. Start Jupyter
jupyter notebook

# 5. Open tutorials/01_basic_agent.ipynb and run it!

💡 Tip: Use git clone --recursive to automatically clone all example repositories

Done! Your first agent should be running. ✅

🔑 Team Registration & API Keys

Step 1: Form Your Team

• Team size: 3-5 members (required)
• Form teams on-site at UCL East - Marshgate, London

Step 2: Register Your Team

1. After forming your team, fill out the registration form:

   🔗 Team Registration Form

2. Upon successful registration, your team will receive:

   • Team ID and API Token (AWS Bedrock credentials)

3. For AWS SageMaker Notebook Instance access, DM Zekun Wu (@zekunwu_73994) on Discord

Step 3: Configure Your Environment Add your team credentials to .env:

HOLISTIC_AI_TEAM_ID=your-team-id
HOLISTIC_AI_API_TOKEN=your-token

Need Help?

• Join Discord
• DM Zekun Wu (@zekunwu_73994) for any registration or API key issues

📚 Resources: API Guide

🎯 Next Steps

1. Pick a track: Track A | Track B | Track C
2. Complete tutorials: See tutorials/README.md
3. Start building: Use core/ folder or build from scratch

🆘 Common Issues

"Module not found"

pip install -r requirements.txt --force-reinstall

"API key not found"

# Check .env file exists and has correct values
cat .env

Jupyter won't start

pip install jupyter
jupyter notebook --port=8889

Still stuck?

• Discord (fastest): #ask-for-help
• GitHub Issues: Report a bug
• Contact: @zekunwu_73994 on Discord

📅 Timeline & Important Dates

Event	Date & Time (GMT)
Registration Opens	November 1, 2025
Event Day 1	November 15, 2025, 9:00 AM - 7:30 PM GMT
Track Release	November 15, 2025, 10:45 AM GMT 🚀
Event Day 2	November 16, 2025, 9:00 AM - 6:00 PM GMT
Submission Deadline	November 16, 2025, 3:00 PM GMT ⏰
Winners Announced	November 16, 2025, 5:00 PM GMT 🏆

⚠️ Late submissions will not be accepted. Devpost timestamps are final.

📋 Full Schedule: View detailed event schedule →

🏆 Three Tracks, Three Challenges

Choose your path — compete in one track or all three! Each track is judged separately.

Click on any track below to view detailed information, tutorials, and requirements:

Track A: Agent Iron Man Build agents that don't break. Performance, Robustness, Cost Efficiency

Track B: Agent Glass Box Follow the trajectory. Understand the behavior. Observability, Explainability, Transparency

Track C: Dear Grandma Attack like a red-team. Assess like a professional. Security, Red Teaming, Vulnerability Discovery

📚 Learning Resources

New to AI agents? Start with our tutorials. Ready to build? Jump to your track's guide.

Tutorials

8 notebooks covering basics to production: View all →

• 01_basic_agent.ipynb — Build your first ReAct agent
• 02_custom_tools.ipynb — Create custom tools
• 03_structured_output.ipynb — Get validated JSON responses
• 04_model_monitoring.ipynb — Track performance & costs
• 05_observability.ipynb — Deep tracing with LangSmith
• 06_benchmark_evaluation.ipynb — Test on benchmarks
• 07_reinforcement_learning.ipynb — RL training (optional)
• 08_attack_red_teaming.ipynb — Security testing

Additional Resources

See each track's README for code examples, datasets, and additional resources:

• Track A Resources — Code examples and benchmarks
• Track B Resources — Observability case studies and traces
• Track C Resources — Red teaming datasets and benchmarks

📤 Submission

Submit via Devpost: Submit Now →

Team Requirements: 3-5 members (form teams on-site at UCL East - Marshgate, London)

Required Deliverables:

1. Poster (PDF) — Single page, A3-A4 size | Templates →
2. GitHub Repository — Public repo with code, README, results | Starter Kit →
3. Team Information — Name, contact email, 3-5 members (Name | Email | Role), track selection
4. Project Description — Name, description, technologies, achievements

📋 Detailed Submission Requirements

Poster (PDF):

• Visual summary: problem statement, solution, key results, impact
• Single page, A3 or A4 size
• Use templates from templates/
• Upload directly to Devpost

GitHub Repository (Strongly Recommended):

• Public repository with complete code
• README.md with project overview and setup instructions
• Clear reproduction instructions
• Results data and logs
• Include repository URL in Devpost submission form

Team Information (via Devpost submission form):

• Team Name: Your team's name for the hackathon
• Team Contact Email: Email address for prize notifications
• Team Members: List of 3-5 team members
  • Format: Name | Email | Role (one per line)
  • Example:

    John Doe | john@example.com | Developer
    Jane Smith | jane@example.com | Designer
    Bob Johnson | bob@example.com | Researcher
    

• Track Selection: Select all tracks you're competing in (you can participate in multiple tracks)

Project Description:

• Project name and tagline
• Detailed description
• Technologies used
• Key achievements and metrics

For complete submission guidelines, see HACKATHON_RULES.md.

💰 Prizes & Awards

$65,000 Total Prize Pool

• 🏆 Grand Champion: £7,000 + £500 Valyu + $500 AWS = £8,000 total value
• 🥇 Track Winners (per track):
  • 1st: £4,200 + £700 Valyu + $700 AWS = £5,600 total value
  • 2nd: £2,300 + £450 Valyu + $450 AWS = £3,200 total value
  • 3rd: £1,250 + £350 Valyu + $350 AWS = £1,950 total value
• 🎁 Special Awards: 11 awards (£500 each) + 5+ mystery awards (£500 each)
• 🤝 Research Collaboration: Top 4 teams work with Holistic AI

📋 Complete prize & judging details → 🖼️ Poster Session & Judging Process →

📖 Resources & Support

Documentation:

• 📅 Event Schedule • 📋 Rules • ⭐ Judging & Prizes • ❓ FAQ
• 🖼️ Poster Session • 🎨 Poster Templates • 📚 API Guide
• 🤝 Code of Conduct • 👨‍⚖️ Judges

Get Help:

• 💬 Discord (recommended): Join our Discord — Real-time help during hackathon
• 🐛 GitHub Issues: Report bugs or ask questions — Technical issues, feature requests | See examples → (#1, #2, #3)
• 📧 Email: zekun.wu@holisticai.com — Direct contact for urgent matters
• On Discord: Zekun Wu (@zekunwu_73994) for API keys, SageMaker access

🏢 Organizers & Sponsors

Organized by: Holistic AI × University College London

Sponsored by:

• Valyu — AI-powered search platform
• AWS — Cloud infrastructure & SageMaker
• NVIDIA — GPU computing & AI acceleration
• MAPFRE — Insurance innovation

---

Ready to build the future of AI agents?

📝 Register & Submit on Devpost • 💬 Join Discord • 🌐 Visit Website

Made with ❤️ by Holistic AI