Open source file-system and knowledge based agent template. Build AI agents that stay up to date with your knowledge base
Contributing to Knowledge Agent Template
Thank you for your interest in contributing to Knowledge Agent Template!
Reporting Security Vulnerabilities
Do not open a public GitHub issue. See SECURITY.md for how to report vulnerabilities privately.
Reporting Bugs
- Search existing issues before opening a new one
- Include steps to reproduce, expected behavior, and actual behavior
- Include your environment (Node version, OS, browser)
Suggesting Features
- Open a feature request issue
- Describe the use case and why it would be valuable
- If possible, outline a proposed implementation
Development Setup
# Clone the repo
git clone https://github.com/vercel-labs/knowledge-agent-template.git
cd knowledge-agent-template
# Install dependencies
bun install
# Set up environment variables
cp apps/app/.env.example apps/app/.env
# Edit .env with your configuration
# Start dev server
bun run dev
Project Structure
knowledge-agent-template/
├── apps/app/ # Nuxt application (chat UI + API + bots)
├── packages/sdk/ # @savoir/sdk - AI SDK compatible tools
├── packages/agent/ # @savoir/agent - Agent core (router, prompts, tools)
└── docs/ # Documentation
Making Changes
- Fork the repository
- Create a feature branch (
git checkout -b feat/my-feature) - Make your changes
- Run checks:
bun run lint:fix bun run typecheck bun run build - Commit with a descriptive message
- Open a pull request
Code Style
- Follow the existing ESLint configuration (
@hrcd/eslint-config) - See docs/CODING-GUIDELINES.md for detailed guidelines
- Write TypeScript with proper types
- Keep changes focused and minimal
Pull Request Process
- Ensure all checks pass (lint, typecheck, build)
- Update documentation if your change affects user-facing behavior
- Add a clear description of what changed and why
- Request review from maintainers
License
By contributing, you agree that your contributions will be licensed under the MIT License.