# Contribute to Lamatic Open Source – Hacktoberfest 2025

🎉

We’re excited to announce that Lamatic.ai is part of Hacktoberfest 2025! This is your chance to explore, learn, and contribute to our open-source ecosystem while earning cool swag and growing your developer profile.

## About Our Open Source Projects

We have **3 open source repositories** that you can contribute to:

### Lamatic SDK

Helps developers integrate Lamatic.ai’s automation and agentic capabilities into their apps with minimal effort:

- **Easy-to-use APIs** for flows, prompts, and agents
- **Built-in authentication** and client management
- **Ready-to-use utilities** for building scalable AI-driven apps

### Lamatic Docs

Our comprehensive documentation repository (this site):

- **Developer guides** and tutorials
- **API documentation** and examples
- **Integration guides** and best practices

### Lamatic Agent Kits

Pre-built agent templates and tools:

- **Ready-to-use agent templates**
- **Custom agent development tools**
- **Integration examples** and workflows

## Why Contribute?

- Be part of a growing **GenAI + Automation** developer community
- Improve your **open-source portfolio** with meaningful contributions
- Learn **cutting-edge SDK design patterns**
- Earn **Hacktoberfest swag** and recognition

## How to Get Started

### 1. Star & Fork the Repos

Get familiar with our repositories:

- **[Lamatic SDK](https://github.com/Lamatic/lamatic-sdk)** 
- **[Lamatic Docs](https://github.com/Lamatic/Lamatic-Docs)** 
- **[Lamatic Agent Kits](https://github.com/Lamatic/AgentKit)**

### 2. Find Issues

Look for issues tagged with:

- `hacktoberfest`
- `good first issue`
- `help wanted`

Check out our open issues across all repositories:

- **[Lamatic SDK Issues](https://github.com/Lamatic/lamatic-sdk/issues)**
- **[Lamatic Docs Issues](https://github.com/Lamatic/Lamatic-Docs/issues)**
- **[Agent Kits Issues](https://github.com/Lamatic/AgentKit/issues)**

### 3. Make Your Contribution

1. **Fork the repo** & create a feature branch
2. **Write clean, tested, and documented code**
3. **Submit a Pull Request (PR)** with details of your changes

### 4. Submit Your PR

When creating your Pull Request, make sure to:

1. **Add the `hacktoberfest` tag** to your PR title or description
2. **Use a clear, descriptive title** that explains what your PR does
3. **Fill out the PR description template** (see below)
4. **Link to any related issues** you’re addressing

We’ll review your PR, provide feedback, and merge it if everything looks good!

## Contribution Ideas

Here are some ways you can contribute across our **3 repositories** to make Hacktoberfest 2025 amazing:

### Lamatic SDK Contributions

- Add examples of SDK usage (Node.js, Python, etc.)
- Create API reference documentation
- Add code examples and use cases
- Fix bugs or improve test coverage
- Optimize existing code and add performance enhancements
- Suggest and add new features
- Add utility functions

### Lamatic Docs Contributions

- Write documentation improvements (README, tutorials)
- Create integration guides and best practices
- Add developer guides and tutorials
- Improve existing documentation
- Add visual diagrams and examples
- Create video tutorials or walkthroughs

### Agent Kits Contributions

- Create starter templates for Lamatic projects
- Build integration examples and workflows
- Add new agent templates
- Create custom agent development tools
- Add example configurations
- Build demo applications

## Getting Started with Development

### Prerequisites

- Node.js 18+ or Python 3.8+
- Git
- Basic understanding of APIs and SDKs

### Setup

Choose the repository you want to contribute to and follow these steps:

#### For Lamatic SDK:
```
git clone https://github.com/Lamatic/lamatic-sdk.git
cd lamatic-sdk
npm install  # or pip install -r requirements.txt
git checkout -b feature/your-feature-name
```

#### For Lamatic Docs:
```
git clone https://github.com/Lamatic/Lamatic-Docs.git
cd lamatic-docs
npm install
git checkout -b feature/your-feature-name
```

#### For Agent Kits:
```
git clone https://github.com/Lamatic/AgentKit.git
cd agent-kits
npm install  # or pip install -r requirements.txt
git checkout -b feature/your-feature-name
```

## Pull Request Guidelines

### Before Submitting

- [ ] Code follows the project’s style guidelines
- [ ] Self-review of your code
- [ ] Code is properly commented
- [ ] Tests pass locally
- [ ] Documentation is updated

### PR Tagging for Hacktoberfest

To ensure your PR counts for Hacktoberfest 2025, make sure to:

1. **Add `hacktoberfest` to your PR title** 
2. **Include the hacktoberfest tag in your PR description**
3. **Use the `hacktoberfest` label** if available in the repository

This helps maintainers quickly identify Hacktoberfest contributions and ensures proper tracking.

### PR Description Template
```
## Description
Brief description of changes

## Type of Change
- [ ] Bug fix
- [ ] New feature
- [ ] Documentation update
- [ ] Performance improvement

## Testing
Describe the tests you ran to verify your changes

## Hacktoberfest
- [ ] This PR is part of Hacktoberfest 2025
- [ ] I have added the `hacktoberfest` tag to this PR

## Checklist
- [ ] My code follows the style guidelines
- [ ] I have performed a self-review
- [ ] I have commented my code
- [ ] I have made corresponding changes to documentation
```

## Rewards & Recognition

### Hacktoberfest 2025

- Valid PRs will count towards **Hacktoberfest 2025**
- Complete 4 valid PRs to earn your Hacktoberfest swag

### Lamatic Recognition

- **Top contributors** will be featured on our Contributors Hall of Fame
- **Exclusive Lamatic swag** for active contributors
- **Community spotlight** for outstanding contributions

## Community & Support

### Get Help

- Join our **[Slack Community](/content/docs/slack/index.html)**
- Check out our **[Documentation](/content/docs/index.html)**

## Timeline

- **October 1-31, 2025**: Hacktoberfest period
- **Ongoing**: PR reviews and merges
- **End of October**: Contributor recognition and swag distribution

## FAQ

### What counts as a valid contribution?

Any meaningful contribution that improves the project - bug fixes, new features, documentation, tests, or examples.

### How many PRs do I need to make?

You need 4 valid PRs to complete Hacktoberfest, but we encourage as many contributions as you’d like to make!

### What if my PR doesn’t get merged?

Don’t worry! As long as your PR is valid and follows our guidelines, it will count towards Hacktoberfest even if it’s not merged by the end of October.

### Can I work on multiple issues?

Absolutely! Feel free to work on as many issues as you’d like.

* * *

⚠️

Make sure to register for Hacktoberfest 2025 at [hacktoberfest.com](https://hacktoberfest.com/) before making your contributions!

Happy Hacking! 🚀