# Teko

Teko (Task Engine KO) is an AI-powered development automation system built using Laravel and LangChain. It provides autonomous agents for various coding tasks, code reviews, and project management.

## About Teko

Teko is designed to automate development tasks through a series of specialized AI agents. It offers:

- **Code Implementation Agent**: Pulls tasks from Jira/GitHub, implements code, creates PRs, and runs tests
- **Code Review Agent**: Reviews codebase, raises issues and feature requests
- **Story Management Agent**: Sizes stories, rewrites/breaks up stories, prioritizes work, and groups related tasks

## Documentation

* [Installation Guide](Installation)
* [Architecture Overview](architecture)
* [CI/CD Pipeline](cicd)
* [Deployment Guide](deployment)
* [Repository Configuration](repo-config)
* [Environment Setup with Direnv](direnv-setup)
* [Security Information](https://github.com/dodwmd/teko/security/policy)
* [Contributing Guidelines](https://github.com/dodwmd/teko/blob/master/.github/CONTRIBUTING.md)

## Technical Stack

### Backend
- Laravel 10+ (PHP 8.2+)
- LangChain (Python 3.10+)
- MySQL Database
- ChromaDB for vector storage

### Frontend
- Orchid Admin Panel for dashboard and agent management
- Entrust for role-based permissions
- Tailwind CSS
- Alpine.js
- Social authentication via Socialite (Google and GitHub)

### DevOps & Infrastructure
- GitHub Actions for CI/CD
- Docker containers with GitHub Container Registry
- Trunk-based development workflow
- Automated testing and dependency scanning

## Testing Tools
- PHP: PHPUnit, Psalm, PHPStan, Laravel Pint
- Python: pytest, pytest-cov, black, mypy, flake8, isort

## Getting Started

See the [Installation Guide](Installation) for instructions on setting up the project locally or the [Deployment Guide](deployment) for container-based deployment.

## Project Status

This project is currently in the initial development phase with focus on establishing the core architecture, agent system, and admin interfaces.