Smart release coordination tool that automates communication and coordination tasks within software teams by connecting GitHub, JIRA, and Slack.
- Automatic GitHub pull request tracking and status monitoring
- JIRA ticket synchronization and blocker detection
- Automated Slack notifications and daily standup summaries
- Weekly changelog generation from commit history
- Team analytics and bottleneck identification
- RESTful API for integration with other tools
-
Install uv (if not already installed):
curl -LsSf https://astral.sh/uv/install.sh | sh -
Install dependencies:
uv sync
-
Set up the database:
cp .env.example .env # Edit .env with your Supabase credentials (see docs/database-setup.md) # Run database migrations (see setup guide for details) uv run python -m devsync_ai.database.migrations.runner # Verify database connection uv run python scripts/check_database.py
-
Configure other services:
# Edit .env with your GitHub, JIRA, and Slack API keys -
Run the application:
uv run python -m devsync_ai.main
-
Access the API:
- API documentation: http://localhost:8000/docs
- Health check: http://localhost:8000/api/v1/health
- Connect your GitHub repository to Render
- Create a new Web Service with these settings:
- Build Command:
uv sync - Start Command:
uv run python -m devsync_ai.main - Environment: Python 3.11+
- Build Command:
- Add environment variables from your
.env.examplefile - Deploy! Render will automatically handle the rest
All configuration is managed through environment variables. See .env.example for all available settings.
SUPABASE_URLandSUPABASE_SERVICE_ROLE_KEY: Database connection (see Database Setup Guide)GITHUB_TOKEN: GitHub API accessJIRA_URL,JIRA_USERNAME,JIRA_TOKEN: JIRA integrationSLACK_BOT_TOKEN,SLACK_SIGNING_SECRET: Slack integrationSECRET_KEY: Application security
DevSync AI uses Supabase as its database. Follow the Database Setup Guide for detailed instructions on:
- Creating a Supabase project
- Getting your connection credentials
- Running database migrations
- Verifying the setup
Quick verification:
uv run python scripts/check_database.pyThe project follows a modular architecture:
devsync_ai/api/: REST API endpointsdevsync_ai/webhooks/: Webhook handlers for external servicesdevsync_ai/services/: Business logic and external API integrationsdevsync_ai/models/: Data models and validationdevsync_ai/scheduler/: Background tasks and automationdevsync_ai/utils/: Utility functions and helpers
MIT License