# Autonomy Planning Agent (Core)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://www.python.org/downloads/)
[](https://github.com/mehulbhardwaj/autonomy/actions)
**Open source platform enabling humans + AI to collaborate for knowledge work** – An intelligent GitHub planning system with configurable AI agents that learn from your team's patterns and coordinate tasks across humans and specialized AI assistants.
---
## 🎯 Vision
Autonomy transforms GitHub into an intelligent collaboration platform where AI agents work alongside human team members to plan, prioritize, and coordinate work. The platform supports configurable AI agents - from core planning agents to specialized domain experts - all configurable through simple YAML files. Instead of replacing human judgment, it augments team decision-making with memory-driven insights and automated task coordination.
---
## 🚀 Quick Start
### Installation
```bash
# Global CLI installation
pipx install autonomy
# Initialize with your GitHub repository
autonomy init --repo your-org/your-repo
```
### Development Setup
```bash
git clone https://github.com/mehulbhardwaj/autonomy.git
cd autonomy
pip install -e .[dev]
pre-commit install
pytest
```
---
## 🏗️ Architecture Overview
- **Agent Orchestration:** Configurable AI agents for different roles (PM, SDE, QA)
- **LLM Integration:** [OpenRouter](https://openrouter.ai) for unified access to 400+ models
- **Memory System:** Repository-scoped memory for intelligent context and relationship tracking
- **GitHub Integration:** GraphQL + REST for comprehensive GitHub automation
- **Team Communication:** Slack integration for notifications and collaboration
---
## 📋 Core Features
- **CLI Interface:** Planning, ranking, assignment, status, and more
- **GitHub Integration:** Issues, Projects v2, authentication, board bootstrap, hierarchy management
- **Slack Integration:** Basic bot, slash commands, notifications
- **Task Management:** Priority ranking, manual override (pin/unpin), breakdown, dependencies
- **Security & Storage:** OS-native secret storage, basic audit logging
- **Documentation:** Comprehensive user and developer docs
---
## �� Documentation
### Quick Reference
- **[Installation Guide](docs/INSTALLATION.md)** - Get started with Autonomy
- **[User Guide](docs/USER_GUIDE.md)** - Learn how to use Autonomy CLI and features
- **[Configuration](docs/CONFIGURATION.md)** - All configuration options and settings
### For Developers
- **[Technical Architecture](docs/ARCHITECTURE.md)** - System design and implementation details
- **[Product Requirements](docs/REQUIREMENTS.md)** - Product vision, roadmap, and development workflow
- **[Testing Strategy](docs/TEST.md)** - Testing approach and coverage strategy
### Documentation Structure
This project maintains focused documentation with clear separation of concerns:
- **User-facing**: Installation, usage, and configuration guides
- **Developer-facing**: Architecture, requirements, implementation, and testing
- **Cross-references**: Each document references related documentation where appropriate
---
## 🎯 Examples
The `examples/` directory contains configuration templates and examples:
- **[`agent.yml`](examples/agent.yml)** - Example AI agent configuration
- **[`board_cache.json`](examples/board_cache.json)** - GitHub Projects field cache example
### Quick Configuration Examples
**Basic Setup:**
```bash
# Install and authenticate
pipx install autonomy
autonomy auth login
# Initialize repository
autonomy init --repo my-org/my-repo
# Get next task
autonomy next
```
**Slack Integration:**
```bash
# Setup Slack bot
autonomy auth slack install
# Use Slack commands
/autonomy next
/autonomy update 123 --done
/autonomy pin 456
```
**Board Management:**
```bash
# Initialize GitHub Projects board
autonomy board init
# Rank items by priority
autonomy board rank
# Reorder items
autonomy board reorder
```
---
## 🤝 Contributing
We welcome contributions from developers interested in AI-human collaboration and intelligent automation!
1. **Read the docs**: Start with [ARCHITECTURE.md](docs/ARCHITECTURE.md) and [REQUIREMENTS.md](docs/REQUIREMENTS.md)
2. **Setup environment**: Follow [INSTALLATION.md](docs/INSTALLATION.md) for development setup
3. **Pick an issue**: Check [good first issues](https://github.com/mehulbhardwaj/autonomy/labels/good%20first%20issue)
4. **Join discussions**: Participate in issue discussions and planning
---
### Release Strategy
Stable releases are tagged from the `main` branch. Testing releases use commits from the `testing` branch and are published as pre-releases. Development work should occur on feature branches that merge into `testing` before stabilizing in `main`.
---
## 📄 License
This project is licensed under the GNU GPLv3 or later - see the [LICENSE](LICENSE) file for details.
---
**Status:** Active open source development. Contributions welcome!
Raw data
{
"_id": null,
"home_page": null,
"name": "autonomy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "ai, automation, github, workflow, agents, software-development",
"author": null,
"author_email": "Mehul Bhardwaj <mehul@example.com>",
"download_url": "https://files.pythonhosted.org/packages/cb/92/cc6852b9e37eb8ef458a9e56b617a07aa9b24ae1ab8c9448a6201ac7301d/autonomy-0.1.1.tar.gz",
"platform": null,
"description": "# Autonomy Planning Agent (Core)\n\n[](https://www.gnu.org/licenses/gpl-3.0)\n[](https://www.python.org/downloads/)\n[](https://github.com/mehulbhardwaj/autonomy/actions)\n\n**Open source platform enabling humans + AI to collaborate for knowledge work** \u2013 An intelligent GitHub planning system with configurable AI agents that learn from your team's patterns and coordinate tasks across humans and specialized AI assistants.\n\n---\n\n## \ud83c\udfaf Vision\n\nAutonomy transforms GitHub into an intelligent collaboration platform where AI agents work alongside human team members to plan, prioritize, and coordinate work. The platform supports configurable AI agents - from core planning agents to specialized domain experts - all configurable through simple YAML files. Instead of replacing human judgment, it augments team decision-making with memory-driven insights and automated task coordination.\n\n---\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n```bash\n# Global CLI installation\npipx install autonomy\n\n# Initialize with your GitHub repository\nautonomy init --repo your-org/your-repo\n```\n\n### Development Setup\n```bash\ngit clone https://github.com/mehulbhardwaj/autonomy.git\ncd autonomy\npip install -e .[dev]\npre-commit install\npytest\n```\n\n---\n\n## \ud83c\udfd7\ufe0f Architecture Overview\n\n- **Agent Orchestration:** Configurable AI agents for different roles (PM, SDE, QA)\n- **LLM Integration:** [OpenRouter](https://openrouter.ai) for unified access to 400+ models\n- **Memory System:** Repository-scoped memory for intelligent context and relationship tracking\n- **GitHub Integration:** GraphQL + REST for comprehensive GitHub automation\n- **Team Communication:** Slack integration for notifications and collaboration\n\n---\n\n## \ud83d\udccb Core Features\n\n- **CLI Interface:** Planning, ranking, assignment, status, and more\n- **GitHub Integration:** Issues, Projects v2, authentication, board bootstrap, hierarchy management\n- **Slack Integration:** Basic bot, slash commands, notifications\n- **Task Management:** Priority ranking, manual override (pin/unpin), breakdown, dependencies\n- **Security & Storage:** OS-native secret storage, basic audit logging\n- **Documentation:** Comprehensive user and developer docs\n\n---\n\n## \ufffd\ufffd Documentation\n\n### Quick Reference\n- **[Installation Guide](docs/INSTALLATION.md)** - Get started with Autonomy\n- **[User Guide](docs/USER_GUIDE.md)** - Learn how to use Autonomy CLI and features\n- **[Configuration](docs/CONFIGURATION.md)** - All configuration options and settings\n\n### For Developers\n- **[Technical Architecture](docs/ARCHITECTURE.md)** - System design and implementation details\n- **[Product Requirements](docs/REQUIREMENTS.md)** - Product vision, roadmap, and development workflow\n- **[Testing Strategy](docs/TEST.md)** - Testing approach and coverage strategy\n\n### Documentation Structure\nThis project maintains focused documentation with clear separation of concerns:\n- **User-facing**: Installation, usage, and configuration guides\n- **Developer-facing**: Architecture, requirements, implementation, and testing\n- **Cross-references**: Each document references related documentation where appropriate\n\n---\n\n## \ud83c\udfaf Examples\n\nThe `examples/` directory contains configuration templates and examples:\n\n- **[`agent.yml`](examples/agent.yml)** - Example AI agent configuration\n- **[`board_cache.json`](examples/board_cache.json)** - GitHub Projects field cache example\n\n### Quick Configuration Examples\n\n**Basic Setup:**\n```bash\n# Install and authenticate\npipx install autonomy\nautonomy auth login\n\n# Initialize repository\nautonomy init --repo my-org/my-repo\n\n# Get next task\nautonomy next\n```\n\n**Slack Integration:**\n```bash\n# Setup Slack bot\nautonomy auth slack install\n\n# Use Slack commands\n/autonomy next\n/autonomy update 123 --done\n/autonomy pin 456\n```\n\n**Board Management:**\n```bash\n# Initialize GitHub Projects board\nautonomy board init\n\n# Rank items by priority\nautonomy board rank\n\n# Reorder items\nautonomy board reorder\n```\n\n---\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions from developers interested in AI-human collaboration and intelligent automation!\n\n1. **Read the docs**: Start with [ARCHITECTURE.md](docs/ARCHITECTURE.md) and [REQUIREMENTS.md](docs/REQUIREMENTS.md)\n2. **Setup environment**: Follow [INSTALLATION.md](docs/INSTALLATION.md) for development setup\n3. **Pick an issue**: Check [good first issues](https://github.com/mehulbhardwaj/autonomy/labels/good%20first%20issue)\n4. **Join discussions**: Participate in issue discussions and planning\n\n---\n\n### Release Strategy\n\nStable releases are tagged from the `main` branch. Testing releases use commits from the `testing` branch and are published as pre-releases. Development work should occur on feature branches that merge into `testing` before stabilizing in `main`.\n\n---\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the GNU GPLv3 or later - see the [LICENSE](LICENSE) file for details.\n\n---\n\n**Status:** Active open source development. Contributions welcome!\n",
"bugtrack_url": null,
"license": null,
"summary": "Enable human-AI collaboration in software development with the Generate-Verify loop",
"version": "0.1.1",
"project_urls": {
"Changelog": "https://github.com/mehulbhardwaj/autonomy/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/mehulbhardwaj/autonomy#readme",
"Homepage": "https://github.com/mehulbhardwaj/autonomy",
"Issues": "https://github.com/mehulbhardwaj/autonomy/issues",
"Repository": "https://github.com/mehulbhardwaj/autonomy.git"
},
"split_keywords": [
"ai",
" automation",
" github",
" workflow",
" agents",
" software-development"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8bc2b14f8118114794220fdc8df02f48b226d5249ea632924434b0be449f316d",
"md5": "fec4506a783f66c1cc06a1c1012eef2c",
"sha256": "de6bb7f20b2b21f9273a220cbae11ab95c1da1634214b546fd8e6f10791c2658"
},
"downloads": -1,
"filename": "autonomy-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fec4506a783f66c1cc06a1c1012eef2c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 88067,
"upload_time": "2025-07-26T11:51:06",
"upload_time_iso_8601": "2025-07-26T11:51:06.251381Z",
"url": "https://files.pythonhosted.org/packages/8b/c2/b14f8118114794220fdc8df02f48b226d5249ea632924434b0be449f316d/autonomy-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "cb92cc6852b9e37eb8ef458a9e56b617a07aa9b24ae1ab8c9448a6201ac7301d",
"md5": "be10f91cb963e0c499211e5f898eab4c",
"sha256": "93ab0ef4ff7e1c24f460aeffc5b955534f9a14f4559868c0d4820a7b6d0981e5"
},
"downloads": -1,
"filename": "autonomy-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "be10f91cb963e0c499211e5f898eab4c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 94355,
"upload_time": "2025-07-26T11:51:07",
"upload_time_iso_8601": "2025-07-26T11:51:07.742503Z",
"url": "https://files.pythonhosted.org/packages/cb/92/cc6852b9e37eb8ef458a9e56b617a07aa9b24ae1ab8c9448a6201ac7301d/autonomy-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-26 11:51:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mehulbhardwaj",
"github_project": "autonomy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "autonomy"
}
JSON
