# ARIA (Artificial Intelligence Regulation Interface & Agreements)
[](https://opensource.org/licenses/Apache-2.0)
[](https://github.com/antenore/ARIA/actions/workflows/ci.yml)
[](https://github.com/antenore/ARIA)
[](https://github.com/sponsors/antenore)
## What is ARIA?
ARIA is an open-source framework for defining and enforcing AI participation policies in software projects. It provides a standardized way to specify how AI can interact with your codebase, ensuring clear boundaries and responsibilities between human and AI contributors.
## Overview
In an era where AI is increasingly involved in software development, ARIA offers a structured approach to managing AI contributions. Similar to how `.gitignore` helps manage file tracking, ARIA helps manage AI participation through clear, human-readable policies.
## Core Features
- YAML-based policy definition with AWS-style inheritance
- Built-in policy templates for common scenarios
- Policy validation and enforcement tools
- Integration with popular CI/CD platforms
- Human-readable policy documentation generation
- IDE integration for Windsurf, Cursor, and more (coming soon)
## Policy Models
ARIA provides several foundational models for AI participation:
### GUARDIAN
- Complete restriction of AI participation
- Suitable for highly sensitive or regulated projects
### OBSERVER
- AI can only analyze and review code
- Can suggest improvements without direct modifications
- Ideal for security-focused projects
### ASSISTANT
- AI can suggest and generate code
- All contributions require human review and approval
- Maintains strong human oversight
### COLLABORATOR
- AI can contribute to specific project areas
- Different rules for different components
- Granular permission control
### PARTNER
- Maximum AI participation with safety guardrails
- Human oversight on critical changes
- Comprehensive testing requirements
## Quick Start
```bash
# Install ARIA
pip install aria-framework
# Initialize ARIA in your project
ariacli init
# Use a template policy
ariacli template apply assistant
# Validate your policy
ariacli policy validate
# View current permissions
ariacli describe
# Generate IDE rules from policy
ariacli ide rules --ide windsurf
# Generate IDE ignore files
ariacli ide ignore --ide cursor
```
## Policy Example
```yaml
version: 1.0
model: assistant
defaults:
allow: [] # Deny-all by default
require:
- human_review
- tests
paths:
'src/tests/**':
allow:
- generate
- modify
require:
- test_coverage
'docs/**':
allow:
- generate
- modify
- suggest
```
## Human Responsibilities
Project maintainers must:
1. Clearly define AI participation boundaries
2. Review AI-generated contributions
3. Ensure policy compliance
4. Maintain documentation accuracy
## Documentation
### Getting Started
- [Quick Start Guide](docs/guides/getting-started.md)
- [Working with Templates](docs/guides/templates.md)
- [Understanding Policy Inheritance](docs/guides/inheritance.md)
- [Command Line Interface](docs/guides/cli.md)
- [Self-Testing ARIA](docs/guides/self-testing.md)
- [AI Tool Integrations](docs/guides/tool-integration/index.md)
### API Reference
- [Policy API](docs/api/policy.md)
- [Templates API](docs/api/templates.md)
- [Validator API](docs/api/validator.md)
- [CLI API](docs/api/cli.md)
- [Configuration API](docs/api/config.md)
### Technical Documentation
- [Policy Architecture](docs/technical/policy.md)
- [Template System](docs/technical/templates.md)
- [Validation System](docs/technical/validation.md)
- [Configuration](docs/technical/configuration.md)
- [Deployment](docs/technical/deployment.md)
### CI/CD Integration
- [GitHub Actions](docs/ci/github-actions.md)
- [GitLab CI](docs/ci/gitlab-ci.md)
- [Jenkins Pipeline](docs/ci/jenkins.md)
### Tool Integration
- [IDE Integration](docs/guides/tool-integration/index.md)
- [Windsurf](docs/guides/tool-integration/windsurf.md)
- [Cursor](docs/guides/tool-integration/cursor.md)
- [IDE Rules](docs/guides/tool-integration/ide-rules.md)
## Contributing
We welcome contributions! Please see our [Contributing Guide](docs/guides/contributing.md) for guidelines.
## License
ARIA is licensed under the Apache License 2.0. See our [License](docs/guides/license.md) for details.
## Project Status
This project is currently in **alpha stage** development (v0.1.1-alpha). The core concepts and architecture are established, but many features are still being implemented.
### ⚠️ Important Notes for Users and Contributors
- **Limited Maintainer Availability**: This project is maintained on a part-time basis. Response times to issues and pull requests may be delayed.
- **API Stability**: APIs are subject to change without notice during this early stage.
- **Current Focus**:
- Improving IDE integration
- Enhancing policy enforcement mechanisms
- Building comprehensive documentation
- Creating a robust test suite
- **Help Wanted**: See our [ToDo.md](ToDo.md) for prioritized tasks where contributions would be most valuable.
For more details on how to contribute, please see our [Contributing Guide](CONTRIBUTING.md).
## Author
**Antenore Gatta**
- GitHub: [@antenore](https://github.com/antenore)
- GitLab: [@antenore](https://gitlab.com/antenore)
- Email: antenore@simbiosi.org
## Links
- GitHub: [antenore/ARIA](https://github.com/antenore/ARIA)
- GitLab: [antenore/ARIA](https://gitlab.com/antenore/ARIA)
- Documentation: [docs/index.md](docs/index.md)
- Issues: [GitHub Issues](https://github.com/antenore/ARIA/issues)
## GitHub Topics
When searching for this project, look for these topics:
- `ai-regulation`
- `ai-governance`
- `ai-policy`
- `artificial-intelligence`
- `policy-enforcement`
- `development-tools`
## AI Contribution Acknowledgment
In the spirit of transparency and dogfooding our own principles, portions of this project (including code, documentation, and project governance) were developed with the assistance of AI tools. All AI contributions were made under human supervision and review, following the principles outlined in our own ARIA policies.
This acknowledgment serves as a practical example of how AI participation can be transparently disclosed in software projects. For more details, see [AI_CONTRIBUTIONS.md](AI_CONTRIBUTIONS.md).
## Sponsorship
ARIA is an open-source project maintained in my free time. If you find this project useful, please consider supporting its development through [GitHub Sponsors](https://github.com/sponsors/antenore).
Your sponsorship helps:
- Maintain and improve ARIA
- Add new features and integrations
- Create better documentation
- Provide support to users
Thank you for your support! ❤️
Raw data
{
"_id": null,
"home_page": null,
"name": "aria-framework",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "ai, framework, governance, policy, regulation",
"author": "Antenore Gatta",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/31/f5/8dc4b6177ab3d6f222f70d3663975316aaa5efa693892ba5d4801585a6be/aria_framework-0.1.1a0.tar.gz",
"platform": null,
"description": "# ARIA (Artificial Intelligence Regulation Interface & Agreements)\n\n[](https://opensource.org/licenses/Apache-2.0)\n[](https://github.com/antenore/ARIA/actions/workflows/ci.yml)\n[](https://github.com/antenore/ARIA)\n[](https://github.com/sponsors/antenore)\n\n## What is ARIA?\n\nARIA is an open-source framework for defining and enforcing AI participation policies in software projects. It provides a standardized way to specify how AI can interact with your codebase, ensuring clear boundaries and responsibilities between human and AI contributors.\n\n## Overview\n\nIn an era where AI is increasingly involved in software development, ARIA offers a structured approach to managing AI contributions. Similar to how `.gitignore` helps manage file tracking, ARIA helps manage AI participation through clear, human-readable policies.\n\n## Core Features\n\n- YAML-based policy definition with AWS-style inheritance\n- Built-in policy templates for common scenarios\n- Policy validation and enforcement tools\n- Integration with popular CI/CD platforms\n- Human-readable policy documentation generation\n- IDE integration for Windsurf, Cursor, and more (coming soon)\n\n## Policy Models\n\nARIA provides several foundational models for AI participation:\n\n### GUARDIAN\n- Complete restriction of AI participation\n- Suitable for highly sensitive or regulated projects\n\n### OBSERVER\n- AI can only analyze and review code\n- Can suggest improvements without direct modifications\n- Ideal for security-focused projects\n\n### ASSISTANT\n- AI can suggest and generate code\n- All contributions require human review and approval\n- Maintains strong human oversight\n\n### COLLABORATOR\n- AI can contribute to specific project areas\n- Different rules for different components\n- Granular permission control\n\n### PARTNER\n- Maximum AI participation with safety guardrails\n- Human oversight on critical changes\n- Comprehensive testing requirements\n\n## Quick Start\n\n```bash\n# Install ARIA\npip install aria-framework\n\n# Initialize ARIA in your project\nariacli init\n\n# Use a template policy\nariacli template apply assistant\n\n# Validate your policy\nariacli policy validate\n\n# View current permissions\nariacli describe\n\n# Generate IDE rules from policy\nariacli ide rules --ide windsurf\n\n# Generate IDE ignore files\nariacli ide ignore --ide cursor\n```\n\n## Policy Example\n\n```yaml\nversion: 1.0\nmodel: assistant\n\ndefaults:\n allow: [] # Deny-all by default\n require:\n - human_review\n - tests\n\npaths:\n 'src/tests/**':\n allow: \n - generate\n - modify\n require:\n - test_coverage\n\n 'docs/**':\n allow:\n - generate\n - modify\n - suggest\n```\n\n## Human Responsibilities\n\nProject maintainers must:\n1. Clearly define AI participation boundaries\n2. Review AI-generated contributions\n3. Ensure policy compliance\n4. Maintain documentation accuracy\n\n## Documentation\n\n### Getting Started\n- [Quick Start Guide](docs/guides/getting-started.md)\n- [Working with Templates](docs/guides/templates.md)\n- [Understanding Policy Inheritance](docs/guides/inheritance.md)\n- [Command Line Interface](docs/guides/cli.md)\n- [Self-Testing ARIA](docs/guides/self-testing.md)\n- [AI Tool Integrations](docs/guides/tool-integration/index.md)\n\n### API Reference\n- [Policy API](docs/api/policy.md)\n- [Templates API](docs/api/templates.md)\n- [Validator API](docs/api/validator.md)\n- [CLI API](docs/api/cli.md)\n- [Configuration API](docs/api/config.md)\n\n### Technical Documentation\n- [Policy Architecture](docs/technical/policy.md)\n- [Template System](docs/technical/templates.md)\n- [Validation System](docs/technical/validation.md)\n- [Configuration](docs/technical/configuration.md)\n- [Deployment](docs/technical/deployment.md)\n\n### CI/CD Integration\n- [GitHub Actions](docs/ci/github-actions.md)\n- [GitLab CI](docs/ci/gitlab-ci.md)\n- [Jenkins Pipeline](docs/ci/jenkins.md)\n\n### Tool Integration\n- [IDE Integration](docs/guides/tool-integration/index.md)\n - [Windsurf](docs/guides/tool-integration/windsurf.md)\n - [Cursor](docs/guides/tool-integration/cursor.md)\n - [IDE Rules](docs/guides/tool-integration/ide-rules.md)\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](docs/guides/contributing.md) for guidelines.\n\n## License\n\nARIA is licensed under the Apache License 2.0. See our [License](docs/guides/license.md) for details.\n\n## Project Status\n\nThis project is currently in **alpha stage** development (v0.1.1-alpha). The core concepts and architecture are established, but many features are still being implemented.\n\n### \u26a0\ufe0f Important Notes for Users and Contributors\n\n- **Limited Maintainer Availability**: This project is maintained on a part-time basis. Response times to issues and pull requests may be delayed.\n- **API Stability**: APIs are subject to change without notice during this early stage.\n- **Current Focus**: \n - Improving IDE integration\n - Enhancing policy enforcement mechanisms\n - Building comprehensive documentation\n - Creating a robust test suite\n- **Help Wanted**: See our [ToDo.md](ToDo.md) for prioritized tasks where contributions would be most valuable.\n\nFor more details on how to contribute, please see our [Contributing Guide](CONTRIBUTING.md).\n\n## Author\n\n**Antenore Gatta**\n- GitHub: [@antenore](https://github.com/antenore)\n- GitLab: [@antenore](https://gitlab.com/antenore)\n- Email: antenore@simbiosi.org\n\n## Links\n\n- GitHub: [antenore/ARIA](https://github.com/antenore/ARIA)\n- GitLab: [antenore/ARIA](https://gitlab.com/antenore/ARIA)\n- Documentation: [docs/index.md](docs/index.md)\n- Issues: [GitHub Issues](https://github.com/antenore/ARIA/issues)\n\n## GitHub Topics\n\nWhen searching for this project, look for these topics:\n- `ai-regulation`\n- `ai-governance`\n- `ai-policy`\n- `artificial-intelligence`\n- `policy-enforcement`\n- `development-tools`\n\n## AI Contribution Acknowledgment\n\nIn the spirit of transparency and dogfooding our own principles, portions of this project (including code, documentation, and project governance) were developed with the assistance of AI tools. All AI contributions were made under human supervision and review, following the principles outlined in our own ARIA policies.\n\nThis acknowledgment serves as a practical example of how AI participation can be transparently disclosed in software projects. For more details, see [AI_CONTRIBUTIONS.md](AI_CONTRIBUTIONS.md).\n\n## Sponsorship\n\nARIA is an open-source project maintained in my free time. If you find this project useful, please consider supporting its development through [GitHub Sponsors](https://github.com/sponsors/antenore).\n\nYour sponsorship helps:\n- Maintain and improve ARIA\n- Add new features and integrations\n- Create better documentation\n- Provide support to users\n\nThank you for your support! \u2764\ufe0f",
"bugtrack_url": null,
"license": null,
"summary": "Artificial Intelligence Regulation Interface & Agreements",
"version": "0.1.1a0",
"project_urls": {
"Documentation": "https://antenore.readthedocs.io/ARIA",
"Homepage": "https://github.com/antenore/ARIA",
"Issues": "https://github.com/antenore/ARIA/issues",
"Repository": "https://github.com/antenore/ARIA"
},
"split_keywords": [
"ai",
" framework",
" governance",
" policy",
" regulation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f4796448669242feca95ddd662e06cf4034ea461abd787e51b692802d78b6f5c",
"md5": "3d20d80a52948cf8e31b4159628c20ea",
"sha256": "c890ac309288ee307e71c6b1c57122e1f5e64886a15cd89e0536ec742ab503f3"
},
"downloads": -1,
"filename": "aria_framework-0.1.1a0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3d20d80a52948cf8e31b4159628c20ea",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 33238,
"upload_time": "2025-02-26T19:07:14",
"upload_time_iso_8601": "2025-02-26T19:07:14.940986Z",
"url": "https://files.pythonhosted.org/packages/f4/79/6448669242feca95ddd662e06cf4034ea461abd787e51b692802d78b6f5c/aria_framework-0.1.1a0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "31f58dc4b6177ab3d6f222f70d3663975316aaa5efa693892ba5d4801585a6be",
"md5": "e72f7f6a6f6c93052a55956704667683",
"sha256": "99eb041d21f6ed6311fb47d19d964a7904699ab6b996c36e4c7423194f00b126"
},
"downloads": -1,
"filename": "aria_framework-0.1.1a0.tar.gz",
"has_sig": false,
"md5_digest": "e72f7f6a6f6c93052a55956704667683",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 77251,
"upload_time": "2025-02-26T19:07:16",
"upload_time_iso_8601": "2025-02-26T19:07:16.340162Z",
"url": "https://files.pythonhosted.org/packages/31/f5/8dc4b6177ab3d6f222f70d3663975316aaa5efa693892ba5d4801585a6be/aria_framework-0.1.1a0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-26 19:07:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "antenore",
"github_project": "ARIA",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pyyaml",
"specs": [
[
">=",
"6.0.1"
]
]
},
{
"name": "click",
"specs": [
[
">=",
"8.1.7"
]
]
},
{
"name": "rich",
"specs": [
[
">=",
"13.7.0"
]
]
},
{
"name": "pydantic",
"specs": [
[
">=",
"2.6.1"
]
]
},
{
"name": "jsonschema",
"specs": [
[
">=",
"4.21.1"
]
]
}
],
"lcname": "aria-framework"
}
JSON
