tiles.run / tiles
A local-first private AI assistant for everyday use. Runs on-device models with encrypted P2P sync, and supports sharing chats publicly on ATProto.
10
fork

Configure Feed

Select the types of activity you want to include in your feed.

tiles / CONTRIBUTING.md
at main 2.7 kB view raw view code
feynon.eth chore: Add guidelines for AI usage in contributions
549c71ca

Contributing to Tiles#

Thanks for your interest in contributing to Tiles. We welcome contributions of all kinds, including code, documentation, design, and discussion.

To understand the project goals and architecture, start with:

Getting Started#

Instructions for setting up a local development environment and building the project are available in HACKING.md. Please follow those steps before submitting any code changes.

How to Contribute#

You can contribute in several ways:

  • Report bugs or request features by opening an issue
  • Improve documentation or examples
  • Submit pull requests for bug fixes, refactors, or new features
  • Open an RFC discussion for proposals that introduce major features, architectural changes, or significant new areas of functionality

Before starting work, check the existing issues to avoid duplication and to align with current priorities. If you plan to work on a larger change, open an issue or discussion first to confirm scope and approach.

Pull Request Guidelines#

When submitting a pull request:

  • Keep changes focused and scoped to a single concern
  • Follow existing code style and conventions
  • Include clear commit messages and a concise PR description
  • Reference relevant issues where applicable
  • Ensure all checks and tests pass

New inference backends, memory models, and improvements aligned with the roadmap are especially welcome.

Using AI Agents#

This project has specific guidelines for using AI tools when contributing. AI-generated pull requests are not accepted—AI tools may only be used in an assistive capacity.

For detailed information about:

  • What AI assistance is permitted
  • How to properly disclose AI usage
  • Guidelines for AI agents and contributors

Please see AGENTS.md before using AI tools in your contributions.

Communication and Support#

If you have questions or want to discuss ideas, you can reach the team and community via:

Code of Conduct#

By participating in this project, you agree to follow the project’s Code of Conduct. Be respectful, constructive, and collaborative in all interactions.

We appreciate your time and effort in helping build Tiles.