Welcome to the AI Hackathon 🎉
Hey @ottonmq — you're in!
Your project is set up and ready to go, so you can get cracking right away.
Use this issue as your checklist + quick links.
### Checklist for a successful hackathon ✅
- [x] Join [Discord](https://discord.gg/gitlab) and say hi in `#ai-hackathon`.
- [x] Read the challenge.
- [x] Form a clear idea.
- [x] Decide whether to team up.
- [x] Get started.
- [x] Iterate and read further technical resources.
#### Process walkthrough video
<details>
<summary>(click to expand)</summary>
{width=900 height=507}
</details>
### The challenge 🎲
- Anything that removes friction from the software development lifecycle. Automate security fixes.
Streamline code reviews. Generate compliance reports. Flag risks before they become problems.
- The best submissions will tell a story: here's the pain, here's how the agent solves it, here's what changes for developers.
- Chat alone won't qualify. We want to see agents that react to triggers and take action.
- At least one custom public agent or public flow should be created.
### Ideas 💡
See the playlist https://www.youtube.com/watch?v=JjdUkKbmvoY&list=PL05JrBw4t0Kq5vFCEQLrowmwGGi5YmCJK
- VueJS Unit Test Writer — generates unit tests for Vue.js components.
- Issue Triage — helps categorize and prioritize issues automatically.
- Documentation Writer — creates docs using the Knowledge Graph.
- Security Sentinel — CLI agent that monitors and flags security concerns.
- OpenTofu Expert — helps with Infrastructure as Code.
- Jenkins Migration — helps migrate Jenkins pipelines to GitLab CI.
See further examples in our [prompt library](https://about.gitlab.com/gitlab-duo/prompt-library/).
### Team up 👥
Teaming up is half the fun - and you can give other **approved participants** access to your project in a few quick steps.
- Go to https://contributors.gitlab.com/ai-hackathon and log in with your GitLab account.
- Fill in the username of the team member you want to invite.
- The team member gets access to your project, and an e-mail to confirm.
### Help + community 🤝
- [Discord](https://discord.gg/gitlab): ask questions and get help in `#ai-hackathon`.
- [Devpost Discord](https://info.devpost.com/blog/join-the-devpost-discord): find people to team up with.
- Office hours: live troubleshooting + brainstorming (schedule posted on [Discord](https://discord.gg/gitlab)).
### Get started 📌
- [ ] Set your [Default GitLab Duo namespace](https://gitlab.com/-/profile/preferences#user_duo_default_namespace_id)
to `GitLab AI Hackathon`.
Without this, you will **not** be able to test out your agent/flow.
#### Build your idea
There is an [agent](agents/agent.yml.template) and [flow](flows/flow.yml.template) template in your project to help you get started.
The quickest way to get started is by using the [Web IDE](https://docs.gitlab.com/user/project/web_ide/).
- Replace the placeholders in the relevant template.
- Remove the `.template` extension.
- Commit your changes.
- A CI pipeline will run which indicates if your agent/flow configurations are valid.
If the pipeline fails, correct any issues (or reach out in Discord for support).
- [Create a tag](https://docs.gitlab.com/user/project/repository/tags/#create-a-tag) to add your agent/flow
to the public catalog, and enable it in your project.
If you need to refer back to the templates later, you can see the originals in the [participant template](https://gitlab.com/gitlab-ai-hackathon/project-templates/participant-template).
#### Test your agent
> [!note]
> You can skip this section if you have not created an agent.
You can chat with your agent:
- in the [GitLab Duo sidebar](https://docs.gitlab.com/user/gitlab_duo_chat/agentic_chat/#use-gitlab-duo-chat-in-the-gitlab-ui),
by creating a New GitLab Duo Chat and selecting your agent from the list.
- in one of the [available extensions](https://docs.gitlab.com/editor_extensions/#available-extensions).
#### Test your flow
> [!note]
> You can skip this section if you have not created an flow.
Your flow will be given a user identity in the form `@ai-flow-name-gitlab-ai-hackathon`.
You can trigger your flow in an issue or merge request in your project by:
- assigning the `@ai-` user.
- mentioning the `@ai-` handle in a commnet (along with any additional instructions).
### Iterate 🔄
Keep refining your agent/flow until you are happy:
- Commit changes to the agent/flow yml.
- Create a new tag.
- Test the agent/flow.
Explore these technical resources:
- [Get started with GitLab Duo Agent Platform: The complete guide](https://about.gitlab.com/blog/gitlab-duo-agent-platform-complete-getting-started-guide/).
- [GitLab Duo Agent Documentation](https://docs.gitlab.com/user/duo_agent_platform/agents/).
- [GitLab Duo Flows Documentation](https://docs.gitlab.com/user/duo_agent_platform/flows/).
- [Flow schema documentation](https://gitlab.com/gitlab-org/modelops/applied-ml/code-suggestions/ai-assist/-/blob/main/docs/flow_registry/v1.md).
- [Explanation of the different tools](https://docs.gitlab.com/user/duo_agent_platform/agents/tools/).
### Join our agent research study 📝
**Help shape the future of agent development.**
Join our research study - share your experience building AI agents through short weekly check-ins, and receive GitLab swag credits for your contribution.
Take [this 2-minute screener](https://forms.gle/oy6SsT8JjRPLWdvA9) to see if you qualify.
issue