Skip to content

Latest commit

 

History

History
114 lines (71 loc) · 2.57 KB

CONTRIBUTING.md

File metadata and controls

114 lines (71 loc) · 2.57 KB

Contributing to Zep

Thank you for your interest in contributing to Zep! We appreciate your efforts and look forward to collaborating with you.

Getting Started

  1. Fork and Clone: Start by forking the Zep repo. Then, clone your fork locally:

    git clone https://github.com/<your-github-username>/zep.git

  2. Set Upstream: Keep your fork synced with the upstream repo by adding it as a remote:

    git remote add upstream https://github.com/getzep/zep.git

  3. Create a Feature Branch: Always create a new branch for your work. This helps in keeping your changes organized and easier for maintainers to review.

    git checkout -b feature/your-feature-name

Setting "Development" Mode

"Development" mode forces Zep's log level to "debug" and disables caching of the web UI. This is useful when developing Zep locally.

To enable "development" mode, set the ZEP_DEVELOPMENT environment variable to true:

export ZEP_DEVELOPMENT=true

or modify your .env file accordingly.

Building Zep

Follow these steps to build Zep locally:

  1. Navigate to the project root:

    cd zep

  2. Build the project:

    make build

This will produce the binary in ./out/bin.

Running Tests

It's essential to ensure that your code passes all tests. Run the tests using:

make test

If you want to check the coverage, run:

make coverage

Code Linting

Ensure your code adheres to our linting standards:

make lint

Generating Swagger Docs

If you make changes to the API or its documentation, regenerate the Swagger docs:

make swagger

Submitting Changes

  1. Commit Your Changes: Use meaningful commit messages that describe the changes made.

    git add .
git commit -m "Your detailed commit message"

  2. Push to Your Fork:

    git push origin feature/your-feature-name

  3. Open a Pull Request: Navigate to the Zep GitHub repo and click on "New pull request". Choose your fork and the branch you've been working on. Submit the PR with a descriptive message.

Feedback

Maintainers will review your PR and provide feedback. If any changes are needed, make them in your feature branch and push to your fork. The PR will update automatically.

Final Notes

  • Always be respectful and kind.
  • If you're unsure about something, ask. We're here to help.
  • Once again, thank you for contributing to Zep!

If you encounter any issues or have suggestions, please open an issue!