attune-ai 2.1.2__py3-none-any.whl → 2.1.3__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {attune_ai-2.1.2.dist-info → attune_ai-2.1.3.dist-info}/METADATA +90 -407
- {attune_ai-2.1.2.dist-info → attune_ai-2.1.3.dist-info}/RECORD +7 -7
- {attune_ai-2.1.2.dist-info → attune_ai-2.1.3.dist-info}/WHEEL +0 -0
- {attune_ai-2.1.2.dist-info → attune_ai-2.1.3.dist-info}/entry_points.txt +0 -0
- {attune_ai-2.1.2.dist-info → attune_ai-2.1.3.dist-info}/licenses/LICENSE +0 -0
- {attune_ai-2.1.2.dist-info → attune_ai-2.1.3.dist-info}/licenses/LICENSE_CHANGE_ANNOUNCEMENT.md +0 -0
- {attune_ai-2.1.2.dist-info → attune_ai-2.1.3.dist-info}/top_level.txt +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: attune-ai
|
|
3
|
-
Version: 2.1.
|
|
3
|
+
Version: 2.1.3
|
|
4
4
|
Summary: AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (10 patterns including Anthropic-inspired), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration.
|
|
5
5
|
Author-email: Patrick Roebuck <admin@smartaimemory.com>
|
|
6
6
|
Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
|
|
@@ -421,9 +421,9 @@ Requires-Dist: aiohttp<4.0.0,>=3.10.0; extra == "all"
|
|
|
421
421
|
Requires-Dist: filelock<4.0.0,>=3.16.0; extra == "all"
|
|
422
422
|
Dynamic: license-file
|
|
423
423
|
|
|
424
|
-
#
|
|
424
|
+
# Attune AI
|
|
425
425
|
|
|
426
|
-
**AI-powered developer workflows with cost optimization and
|
|
426
|
+
**AI-powered developer workflows with cost optimization and intelligent routing.**
|
|
427
427
|
|
|
428
428
|
Run code review, debugging, testing, and release workflows from your terminal or Claude Code. Smart tier routing saves 34-86% on LLM costs.
|
|
429
429
|
|
|
@@ -431,7 +431,6 @@ Run code review, debugging, testing, and release workflows from your terminal or
|
|
|
431
431
|
[-brightgreen)](https://github.com/Smart-AI-Memory/attune-ai/actions)
|
|
432
432
|
[](https://www.python.org)
|
|
433
433
|
[](LICENSE)
|
|
434
|
-
[](https://github.com/Smart-AI-Memory/attune-ai/blob/main/CHANGELOG.md)
|
|
435
434
|
|
|
436
435
|
```bash
|
|
437
436
|
pip install attune-ai[developer]
|
|
@@ -439,188 +438,38 @@ pip install attune-ai[developer]
|
|
|
439
438
|
|
|
440
439
|
---
|
|
441
440
|
|
|
442
|
-
##
|
|
443
|
-
|
|
444
|
-
**Empathy Framework is evolving to focus exclusively on Anthropic/Claude** to unlock features impossible with multi-provider abstraction:
|
|
445
|
-
|
|
446
|
-
- **📦 Prompt Caching:** 90% cost reduction on repeated prompts
|
|
447
|
-
- **📖 Flexible Context:** 200K via subscription for most tasks, up to 1M via API for large codebases
|
|
448
|
-
- **🧠 Extended Thinking:** See Claude's internal reasoning process
|
|
449
|
-
- **🔧 Advanced Tool Use:** Optimized for agentic workflows
|
|
450
|
-
|
|
451
|
-
**Timeline:**
|
|
452
|
-
|
|
453
|
-
- ✅ **v4.8.0 (Jan 2026):** Deprecation warnings for OpenAI/Google/Ollama providers
|
|
454
|
-
- ✅ **v5.0.0 (Jan 26, 2026):** Non-Anthropic providers removed (BREAKING - COMPLETE)
|
|
455
|
-
- ✅ **v5.0.2 (Jan 28, 2026):** Cost optimization suite with batch processing and caching monitoring
|
|
456
|
-
|
|
457
|
-
**Migration Guide:** [docs/CLAUDE_NATIVE.md](docs/CLAUDE_NATIVE.md)
|
|
458
|
-
|
|
459
|
-
---
|
|
460
|
-
|
|
461
|
-
## What's New in v5.3.0
|
|
462
|
-
|
|
463
|
-
**🎨 Dashboard Enhancements** - Improved usability and clarity:
|
|
464
|
-
|
|
465
|
-
- **Agent Display Names** - Human-readable labels for agents in dashboard (e.g., "Code Analyzer" instead of UUID)
|
|
466
|
-
- **Comprehensive Help Panel** - 5-section accordion explaining dashboard features, use cases, and Redis setup
|
|
467
|
-
- **UX Improvements** - "Source Agent:" label clarity, "Redis Requires Enabling" status message
|
|
468
|
-
- **Browser Cache Busting** - Date-based versioning ensures updates appear immediately
|
|
469
|
-
|
|
470
|
-
**📚 Documentation Improvements**:
|
|
471
|
-
|
|
472
|
-
- Clarified flexible context strategy (200K subscription + 1M API routing)
|
|
473
|
-
- Added Redis requirement documentation for dashboard
|
|
474
|
-
- Root directory cleanup (8 archived files)
|
|
475
|
-
|
|
476
|
-
**🧪 Test Infrastructure**:
|
|
477
|
-
|
|
478
|
-
- Sequential test execution to fix import timing issues
|
|
479
|
-
- All agent tracking tests passing (19/19)
|
|
441
|
+
## Key Features
|
|
480
442
|
|
|
481
|
-
|
|
443
|
+
### Claude-Native Architecture
|
|
482
444
|
|
|
483
|
-
|
|
445
|
+
Attune AI is built exclusively for Anthropic/Claude, unlocking features impossible with multi-provider abstraction:
|
|
484
446
|
|
|
485
|
-
|
|
447
|
+
- **Prompt Caching** - 90% cost reduction on repeated prompts
|
|
448
|
+
- **Flexible Context** - 200K via subscription, up to 1M via API for large codebases
|
|
449
|
+
- **Extended Thinking** - Access Claude's internal reasoning process
|
|
450
|
+
- **Advanced Tool Use** - Optimized for agentic workflows
|
|
486
451
|
|
|
487
|
-
|
|
452
|
+
### Multi-Agent Orchestration
|
|
488
453
|
|
|
489
|
-
|
|
490
|
-
- Agent heartbeats and status tracking
|
|
491
|
-
- Inter-agent coordination signals
|
|
492
|
-
- Event streaming across agent workflows
|
|
493
|
-
- Approval gates for human-in-the-loop
|
|
494
|
-
- Quality feedback and performance metrics
|
|
495
|
-
- Demo mode with test data generation
|
|
454
|
+
Full support for custom agents and Anthropic LLM agents:
|
|
496
455
|
|
|
456
|
+
- **Agent Coordination Dashboard** - Real-time monitoring with 6 coordination patterns
|
|
497
457
|
- **Custom Agents** - Build specialized agents for your workflow needs
|
|
498
|
-
- **
|
|
499
|
-
- Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py` **(Requires Redis)**
|
|
500
|
-
|
|
501
|
-
**🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:
|
|
458
|
+
- **Inter-Agent Communication** - Heartbeats, signals, events, and approval gates
|
|
502
459
|
|
|
503
|
-
|
|
504
|
-
# Interactive setup
|
|
505
|
-
python -m attune.models.auth_cli setup
|
|
506
|
-
|
|
507
|
-
# View current configuration
|
|
508
|
-
python -m attune.models.auth_cli status
|
|
509
|
-
|
|
510
|
-
# Get recommendation for a file
|
|
511
|
-
python -m attune.models.auth_cli recommend src/module.py
|
|
512
|
-
```
|
|
513
|
-
|
|
514
|
-
**💰 Automatic Cost Optimization** - Workflows choose the best auth method:
|
|
515
|
-
|
|
516
|
-
- Small/medium modules (<2000 LOC) → Claude subscription (free)
|
|
517
|
-
- Large modules (>2000 LOC) → Anthropic API (pay for what you need)
|
|
518
|
-
- 7 workflows integrated: document-gen, test-gen, code-review, bug-predict, security-audit, perf-audit, release-prep
|
|
519
|
-
- Auth mode tracking in all workflow outputs for telemetry
|
|
520
|
-
|
|
521
|
-
**🧪 Comprehensive Testing** - 7 new integration tests for auth strategy:
|
|
522
|
-
|
|
523
|
-
- All workflows tested with auth enabled/disabled
|
|
524
|
-
- API and subscription mode verification
|
|
525
|
-
- Cost tracking validation
|
|
526
|
-
|
|
527
|
-
**📖 Documentation** - 950+ lines across 3 guides:
|
|
528
|
-
|
|
529
|
-
- [AUTH_STRATEGY_GUIDE.md](docs/AUTH_STRATEGY_GUIDE.md) - User guide for configuration
|
|
530
|
-
- [AUTH_CLI_IMPLEMENTATION.md](docs/AUTH_CLI_IMPLEMENTATION.md) - CLI command reference
|
|
531
|
-
- [AUTH_WORKFLOW_INTEGRATIONS.md](docs/AUTH_WORKFLOW_INTEGRATIONS.md) - Integration patterns
|
|
532
|
-
|
|
533
|
-
[See Full Changelog](CHANGELOG.md#510---2026-01-29)
|
|
534
|
-
|
|
535
|
-
---
|
|
536
|
-
|
|
537
|
-
## What's New in v5.0.2
|
|
538
|
-
|
|
539
|
-
**💰 50% Cost Savings with Batch API** - Process non-urgent tasks asynchronously:
|
|
540
|
-
|
|
541
|
-
```bash
|
|
542
|
-
empathy batch submit batch_requests.json # Submit batch job
|
|
543
|
-
empathy batch status msgbatch_abc123 # Check progress
|
|
544
|
-
empathy batch results msgbatch_abc123 output.json # Download results
|
|
545
|
-
```
|
|
460
|
+
### Intelligent Cost Optimization
|
|
546
461
|
|
|
547
|
-
|
|
462
|
+
- **$0 in Claude Code** - Workflows run as skills through Claude's Task tool
|
|
463
|
+
- **Smart Tier Routing** - Automatically selects the right model for each task
|
|
464
|
+
- **Authentication Strategy** - Routes between subscription and API based on codebase size
|
|
548
465
|
|
|
549
|
-
|
|
466
|
+
### Socratic Workflows
|
|
550
467
|
|
|
551
|
-
|
|
552
|
-
- 3-tier fallback: API → tiktoken (local) → heuristic
|
|
553
|
-
- Cache-aware cost calculation (25% write markup, 90% read discount)
|
|
554
|
-
|
|
555
|
-
**📈 Cache Performance Monitoring** - Track your 20-30% caching savings:
|
|
556
|
-
|
|
557
|
-
```bash
|
|
558
|
-
empathy cache stats # Show hit rates and cost savings
|
|
559
|
-
empathy cache stats --verbose # Detailed token metrics
|
|
560
|
-
empathy cache stats --format json # Machine-readable output
|
|
561
|
-
```
|
|
562
|
-
|
|
563
|
-
**🧭 Adaptive Routing Analytics** - Intelligent tier recommendations:
|
|
564
|
-
|
|
565
|
-
```bash
|
|
566
|
-
empathy routing stats <workflow> # Performance metrics
|
|
567
|
-
empathy routing check --all # Tier upgrade recommendations
|
|
568
|
-
empathy routing models --provider anthropic # Compare models
|
|
569
|
-
```
|
|
570
|
-
|
|
571
|
-
**🔧 Dashboard Fixes** - All 6 agent coordination patterns now operational:
|
|
572
|
-
- Agent heartbeats displaying correctly
|
|
573
|
-
- Event streaming functional
|
|
574
|
-
- Coordination signals working
|
|
575
|
-
- Approval gates operational
|
|
576
|
-
|
|
577
|
-
[See Full Changelog](CHANGELOG.md#502---2026-01-28) | [Batch API Guide](docs/BATCH_API_GUIDE.md) | [User API Docs](docs/USER_API_DOCUMENTATION.md)
|
|
578
|
-
|
|
579
|
-
---
|
|
580
|
-
|
|
581
|
-
## What's New in v4.9.0
|
|
582
|
-
|
|
583
|
-
**⚡ 18x Faster Performance** - Massive performance gains through Phase 2 optimizations:
|
|
584
|
-
|
|
585
|
-
- **Redis Two-Tier Caching:** 2x faster memory operations (37,000x for cached keys)
|
|
586
|
-
- **Generator Expressions:** 99.9% memory reduction across 27 optimizations
|
|
587
|
-
- **Parallel Scanning:** Multi-core processing enabled by default (2-4x faster)
|
|
588
|
-
- **Incremental Scanning:** Git diff-based updates (10x faster)
|
|
589
|
-
|
|
590
|
-
**🧭 Natural Language Workflows** - Use plain English instead of workflow names:
|
|
591
|
-
|
|
592
|
-
```bash
|
|
593
|
-
/workflows "find security vulnerabilities" # → security-audit
|
|
594
|
-
/workflows "check code performance" # → perf-audit
|
|
595
|
-
/workflows "predict bugs" # → bug-predict
|
|
596
|
-
/plan "review my code" # → code-review
|
|
597
|
-
```
|
|
598
|
-
|
|
599
|
-
**📊 Real-World Performance:**
|
|
600
|
-
|
|
601
|
-
- Combined workflow: 3.59s → 0.2s (**18x faster**)
|
|
602
|
-
- Full scan: 3,472 files in 0.98s (was 3.59s)
|
|
603
|
-
- Redis cached operations: 37ms → 0.001ms
|
|
604
|
-
|
|
605
|
-
**🎯 Improved Navigation:**
|
|
606
|
-
|
|
607
|
-
- Split `/workflow` into `/workflows` (automated analysis) and `/plan` (planning/review)
|
|
608
|
-
- Clearer hub organization with better categorization
|
|
609
|
-
- Natural language routing matches intent to workflow
|
|
610
|
-
|
|
611
|
-
[See CHANGELOG.md](CHANGELOG.md) | [Performance Docs](docs/REDIS_OPTIMIZATION_SUMMARY.md)
|
|
612
|
-
|
|
613
|
-
---
|
|
614
|
-
|
|
615
|
-
## What's New in v4.7.0
|
|
616
|
-
|
|
617
|
-
**$0 Workflows via Skills** - Multi-agent workflows run through Claude Code's Task tool instead of API calls. No additional cost with your Claude subscription.
|
|
618
|
-
|
|
619
|
-
**Socratic Workflows** - Interactive discovery through guided questions. Workflows ask what you need rather than requiring upfront configuration.
|
|
620
|
-
|
|
621
|
-
**Security Hardened** - Fixed critical vulnerabilities (path traversal, JWT, SSRF).
|
|
468
|
+
Workflows guide you through discovery instead of requiring upfront configuration:
|
|
622
469
|
|
|
623
|
-
|
|
470
|
+
- **Interactive Discovery** - Asks targeted questions to understand your needs
|
|
471
|
+
- **Context Gathering** - Collects relevant code, errors, and constraints
|
|
472
|
+
- **Dynamic Agent Creation** - Assembles the right team based on your answers
|
|
624
473
|
|
|
625
474
|
---
|
|
626
475
|
|
|
@@ -638,74 +487,31 @@ pip install attune-ai[developer]
|
|
|
638
487
|
# Auto-detect API keys
|
|
639
488
|
python -m attune.models.cli provider
|
|
640
489
|
|
|
641
|
-
# Or
|
|
642
|
-
python -m attune.models.
|
|
490
|
+
# Or configure authentication strategy
|
|
491
|
+
python -m attune.models.auth_cli setup
|
|
643
492
|
```
|
|
644
493
|
|
|
645
|
-
### 3. Use
|
|
646
|
-
|
|
647
|
-
**In Claude Code:**
|
|
494
|
+
### 3. Use in Claude Code
|
|
648
495
|
|
|
649
496
|
```bash
|
|
650
497
|
/dev # Developer tools (debug, commit, PR, review)
|
|
651
|
-
/testing # Run tests, coverage, benchmarks
|
|
498
|
+
/testing # Run tests, coverage analysis, benchmarks
|
|
652
499
|
/workflows # Automated analysis (security, bugs, perf)
|
|
653
|
-
/plan # Planning, TDD, code review
|
|
500
|
+
/plan # Planning, TDD, code review, refactoring
|
|
654
501
|
/docs # Documentation generation
|
|
655
502
|
/release # Release preparation
|
|
656
503
|
|
|
657
504
|
# Natural language support:
|
|
658
505
|
/workflows "find security issues"
|
|
659
506
|
/plan "review my code"
|
|
660
|
-
|
|
661
|
-
# Direct tool access via MCP (v5.1.1+):
|
|
662
|
-
# Claude Code automatically discovers Empathy tools through the MCP server
|
|
663
|
-
# Just describe what you need in natural language:
|
|
664
|
-
"Run a security audit on src/" → Invokes security_audit tool
|
|
665
|
-
"Generate tests for config.py" → Invokes test_generation tool
|
|
666
|
-
"Check my auth configuration" → Invokes auth_status tool
|
|
667
|
-
"Analyze performance bottlenecks" → Invokes performance_audit tool
|
|
668
507
|
```
|
|
669
508
|
|
|
670
|
-
|
|
671
|
-
|
|
672
|
-
Empathy Framework now includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
|
|
673
|
-
|
|
674
|
-
- **10 Tools Available:** security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, auth_status, auth_recommend, telemetry_stats, dashboard_status
|
|
675
|
-
- **Automatic Discovery:** No manual configuration needed - Claude Code finds tools via `.claude/mcp.json`
|
|
676
|
-
- **Natural Language Access:** Describe your need and Claude invokes the appropriate tool
|
|
677
|
-
- **Verification Hooks:** Automatic validation of Python/JSON files and workflow outputs
|
|
678
|
-
|
|
679
|
-
To verify MCP integration:
|
|
509
|
+
### 4. Use via CLI
|
|
680
510
|
|
|
681
511
|
```bash
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
# Restart Claude Code to load the MCP server
|
|
686
|
-
# Tools will appear in Claude's tool list automatically
|
|
687
|
-
```
|
|
688
|
-
|
|
689
|
-
See [.claude/MCP_TEST_RESULTS.md](.claude/MCP_TEST_RESULTS.md) for full integration details.
|
|
690
|
-
|
|
691
|
-
**CLI:**
|
|
692
|
-
|
|
693
|
-
```bash
|
|
694
|
-
empathy workflow run security-audit --path ./src
|
|
695
|
-
empathy workflow run test-coverage --target 90
|
|
696
|
-
empathy telemetry show # View cost savings
|
|
697
|
-
```
|
|
698
|
-
|
|
699
|
-
**Python:**
|
|
700
|
-
|
|
701
|
-
```python
|
|
702
|
-
from attune import EmpathyOS
|
|
703
|
-
|
|
704
|
-
async with EmpathyOS() as empathy:
|
|
705
|
-
result = await empathy.level_2_guided(
|
|
706
|
-
"Review this code for security issues"
|
|
707
|
-
)
|
|
708
|
-
print(result["response"])
|
|
512
|
+
attune workflow run security-audit --path ./src
|
|
513
|
+
attune workflow run test-coverage --target 90
|
|
514
|
+
attune telemetry show # View cost savings
|
|
709
515
|
```
|
|
710
516
|
|
|
711
517
|
---
|
|
@@ -722,67 +528,14 @@ Workflows are organized into hubs for easy discovery:
|
|
|
722
528
|
| **Release** | `/release` | Release prep, security scan, publishing |
|
|
723
529
|
| **Workflows** | `/workflows` | Automated analysis (security, bugs, perf) |
|
|
724
530
|
| **Plan** | `/plan` | Planning, TDD, code review, refactoring |
|
|
725
|
-
| **Utilities** | `/utilities` | Project init, dependencies, profiling |
|
|
726
|
-
| **Learning** | `/learning` | Pattern learning and session evaluation |
|
|
727
|
-
| **Context** | `/context` | State management and memory |
|
|
728
531
|
| **Agent** | `/agent` | Create and manage custom agents |
|
|
729
532
|
|
|
730
|
-
**Natural Language
|
|
533
|
+
**Natural Language Routing:**
|
|
731
534
|
|
|
732
535
|
```bash
|
|
733
|
-
# Use plain English - intelligent routing matches your intent
|
|
734
536
|
/workflows "find security vulnerabilities" # → security-audit
|
|
735
537
|
/workflows "check code performance" # → perf-audit
|
|
736
|
-
/workflows "predict bugs" # → bug-predict
|
|
737
538
|
/plan "review my code" # → code-review
|
|
738
|
-
/plan "help me plan this feature" # → planning
|
|
739
|
-
|
|
740
|
-
# Or use traditional workflow names
|
|
741
|
-
/workflows security-audit
|
|
742
|
-
/plan code-review
|
|
743
|
-
```
|
|
744
|
-
|
|
745
|
-
**Interactive menus:**
|
|
746
|
-
|
|
747
|
-
```bash
|
|
748
|
-
/dev # Show interactive menu
|
|
749
|
-
/dev "debug auth error" # Jump directly to debugging
|
|
750
|
-
/testing "run coverage" # Run coverage analysis
|
|
751
|
-
/release # Start release preparation
|
|
752
|
-
```
|
|
753
|
-
|
|
754
|
-
---
|
|
755
|
-
|
|
756
|
-
## Socratic Method
|
|
757
|
-
|
|
758
|
-
Workflows guide you through discovery instead of requiring upfront configuration:
|
|
759
|
-
|
|
760
|
-
```text
|
|
761
|
-
You: /dev
|
|
762
|
-
|
|
763
|
-
Claude: What development task do you need?
|
|
764
|
-
1. Debug issue
|
|
765
|
-
2. Create commit
|
|
766
|
-
3. PR workflow
|
|
767
|
-
4. Quality check
|
|
768
|
-
|
|
769
|
-
You: 1
|
|
770
|
-
|
|
771
|
-
Claude: What error or unexpected behavior are you seeing?
|
|
772
|
-
```
|
|
773
|
-
|
|
774
|
-
**How it works:**
|
|
775
|
-
|
|
776
|
-
1. **Discovery** - Workflow asks targeted questions to understand your needs
|
|
777
|
-
2. **Context gathering** - Collects relevant code, errors, and constraints
|
|
778
|
-
3. **Dynamic agent creation** - Assembles the right team based on your answers
|
|
779
|
-
4. **Execution** - Runs with appropriate tier selection
|
|
780
|
-
|
|
781
|
-
**Create custom agents with Socratic guidance:**
|
|
782
|
-
|
|
783
|
-
```bash
|
|
784
|
-
/agent create # Guided agent creation
|
|
785
|
-
/agent team # Build multi-agent teams interactively
|
|
786
539
|
```
|
|
787
540
|
|
|
788
541
|
---
|
|
@@ -797,120 +550,93 @@ When using Claude Code, workflows run as skills through the Task tool - **no API
|
|
|
797
550
|
/dev # $0 - uses your Claude subscription
|
|
798
551
|
/testing # $0
|
|
799
552
|
/release # $0
|
|
800
|
-
/agent create # $0
|
|
801
553
|
```
|
|
802
554
|
|
|
803
555
|
### API Mode (CI/CD, Automation)
|
|
804
556
|
|
|
805
557
|
For programmatic use, smart tier routing saves 34-86%:
|
|
806
558
|
|
|
807
|
-
| Tier | Model
|
|
808
|
-
| ------- |
|
|
809
|
-
| CHEAP | Haiku
|
|
810
|
-
| CAPABLE | Sonnet
|
|
811
|
-
| PREMIUM | Opus
|
|
559
|
+
| Tier | Model | Use Case | Cost |
|
|
560
|
+
| ------- | ------------- | ---------------------------- | ------- |
|
|
561
|
+
| CHEAP | Haiku | Formatting, simple tasks | ~$0.005 |
|
|
562
|
+
| CAPABLE | Sonnet | Bug fixes, code review | ~$0.08 |
|
|
563
|
+
| PREMIUM | Opus | Architecture, complex design | ~$0.45 |
|
|
812
564
|
|
|
813
565
|
```bash
|
|
814
566
|
# Track API usage and savings
|
|
815
|
-
|
|
567
|
+
attune telemetry savings --days 30
|
|
816
568
|
```
|
|
817
569
|
|
|
818
570
|
---
|
|
819
571
|
|
|
820
|
-
##
|
|
572
|
+
## MCP Server Integration
|
|
821
573
|
|
|
822
|
-
|
|
574
|
+
Attune AI includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
|
|
823
575
|
|
|
824
|
-
|
|
825
|
-
|
|
826
|
-
|
|
576
|
+
- **10 Tools Available** - security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, and more
|
|
577
|
+
- **Automatic Discovery** - Claude Code finds tools via `.claude/mcp.json`
|
|
578
|
+
- **Natural Language Access** - Describe your need and Claude invokes the appropriate tool
|
|
827
579
|
|
|
828
|
-
|
|
829
|
-
|
|
830
|
-
|
|
831
|
-
|
|
832
|
-
### Response Caching
|
|
833
|
-
|
|
834
|
-
Up to 57% cache hit rate on similar prompts. Zero config needed.
|
|
835
|
-
|
|
836
|
-
```python
|
|
837
|
-
from attune.workflows import SecurityAuditWorkflow
|
|
838
|
-
|
|
839
|
-
workflow = SecurityAuditWorkflow(enable_cache=True)
|
|
840
|
-
result = await workflow.execute(target_path="./src")
|
|
841
|
-
print(f"Cache hit rate: {result.cost_report.cache_hit_rate:.1f}%")
|
|
580
|
+
```bash
|
|
581
|
+
# Verify MCP integration
|
|
582
|
+
echo '{"method":"tools/list","params":{}}' | PYTHONPATH=./src python -m attune.mcp.server
|
|
842
583
|
```
|
|
843
584
|
|
|
844
|
-
|
|
845
|
-
|
|
846
|
-
Workflows learn from outcomes and improve over time:
|
|
585
|
+
---
|
|
847
586
|
|
|
848
|
-
|
|
849
|
-
from attune.orchestration.config_store import ConfigurationStore
|
|
587
|
+
## Agent Coordination Dashboard
|
|
850
588
|
|
|
851
|
-
|
|
852
|
-
best = store.get_best_for_task("release_prep")
|
|
853
|
-
print(f"Success rate: {best.success_rate:.1%}")
|
|
854
|
-
```
|
|
589
|
+
Real-time monitoring with 6 coordination patterns:
|
|
855
590
|
|
|
856
|
-
|
|
591
|
+
- Agent heartbeats and status tracking
|
|
592
|
+
- Inter-agent coordination signals
|
|
593
|
+
- Event streaming across agent workflows
|
|
594
|
+
- Approval gates for human-in-the-loop
|
|
595
|
+
- Quality feedback and performance metrics
|
|
596
|
+
- Demo mode with test data generation
|
|
857
597
|
|
|
858
|
-
```
|
|
859
|
-
|
|
860
|
-
|
|
861
|
-
|
|
862
|
-
GeminiProvider, # Gemini
|
|
863
|
-
LocalProvider, # Ollama, LM Studio
|
|
864
|
-
)
|
|
598
|
+
```bash
|
|
599
|
+
# Launch dashboard (requires Redis)
|
|
600
|
+
python examples/dashboard_demo.py
|
|
601
|
+
# Open http://localhost:8000
|
|
865
602
|
```
|
|
866
603
|
|
|
867
604
|
---
|
|
868
605
|
|
|
869
|
-
##
|
|
606
|
+
## Authentication Strategy
|
|
607
|
+
|
|
608
|
+
Intelligent routing between Claude subscription and Anthropic API:
|
|
870
609
|
|
|
871
610
|
```bash
|
|
872
|
-
#
|
|
873
|
-
python -m attune.models.
|
|
874
|
-
python -m attune.models.cli provider --set hybrid
|
|
611
|
+
# Interactive setup
|
|
612
|
+
python -m attune.models.auth_cli setup
|
|
875
613
|
|
|
876
|
-
#
|
|
877
|
-
|
|
878
|
-
empathy workflow run <workflow-name>
|
|
614
|
+
# View current configuration
|
|
615
|
+
python -m attune.models.auth_cli status
|
|
879
616
|
|
|
880
|
-
#
|
|
881
|
-
|
|
882
|
-
|
|
883
|
-
empathy telemetry export --format csv
|
|
617
|
+
# Get recommendation for a file
|
|
618
|
+
python -m attune.models.auth_cli recommend src/module.py
|
|
619
|
+
```
|
|
884
620
|
|
|
885
|
-
|
|
886
|
-
empathy orchestrate release-prep
|
|
887
|
-
empathy orchestrate test-coverage --target 90
|
|
621
|
+
**Automatic routing:**
|
|
888
622
|
|
|
889
|
-
|
|
890
|
-
|
|
891
|
-
empathy meta-workflow run release-prep --real
|
|
892
|
-
```
|
|
623
|
+
- Small/medium modules (<2000 LOC) → Claude subscription (free)
|
|
624
|
+
- Large modules (>2000 LOC) → Anthropic API (pay for what you need)
|
|
893
625
|
|
|
894
626
|
---
|
|
895
627
|
|
|
896
|
-
##
|
|
628
|
+
## Installation Options
|
|
897
629
|
|
|
898
630
|
```bash
|
|
899
631
|
# Individual developers (recommended)
|
|
900
632
|
pip install attune-ai[developer]
|
|
901
633
|
|
|
902
|
-
# All LLM providers
|
|
903
|
-
pip install attune-ai[llm]
|
|
904
|
-
|
|
905
634
|
# With caching (semantic similarity)
|
|
906
635
|
pip install attune-ai[cache]
|
|
907
636
|
|
|
908
637
|
# Enterprise (auth, rate limiting)
|
|
909
638
|
pip install attune-ai[enterprise]
|
|
910
639
|
|
|
911
|
-
# Healthcare (HIPAA compliance)
|
|
912
|
-
pip install attune-ai[healthcare]
|
|
913
|
-
|
|
914
640
|
# Development
|
|
915
641
|
git clone https://github.com/Smart-AI-Memory/attune-ai.git
|
|
916
642
|
cd attune-ai && pip install -e .[dev]
|
|
@@ -921,74 +647,38 @@ cd attune-ai && pip install -e .[dev]
|
|
|
921
647
|
## Environment Setup
|
|
922
648
|
|
|
923
649
|
```bash
|
|
924
|
-
#
|
|
650
|
+
# Required: Anthropic API key
|
|
925
651
|
export ANTHROPIC_API_KEY="sk-ant-..."
|
|
926
|
-
export OPENAI_API_KEY="sk-..."
|
|
927
|
-
export GOOGLE_API_KEY="..."
|
|
928
652
|
|
|
929
|
-
# Optional
|
|
653
|
+
# Optional: Redis for Agent Dashboard and memory
|
|
930
654
|
export REDIS_URL="redis://localhost:6379"
|
|
931
655
|
```
|
|
932
656
|
|
|
933
657
|
---
|
|
934
658
|
|
|
935
|
-
## VSCode Extension
|
|
936
|
-
|
|
937
|
-
Install the Empathy VSCode extension for:
|
|
938
|
-
|
|
939
|
-
- **Dashboard** - Health score, costs, patterns
|
|
940
|
-
- **One-Click Workflows** - Run from command palette
|
|
941
|
-
- **Memory Panel** - Manage Redis and patterns
|
|
942
|
-
- **Cost Tracking** - Real-time savings display
|
|
943
|
-
|
|
944
|
-
---
|
|
945
|
-
|
|
946
|
-
## Documentation
|
|
947
|
-
|
|
948
|
-
- [Quick Start Guide](docs/quickstart.md)
|
|
949
|
-
- [CLI Reference](docs/cli-reference.md)
|
|
950
|
-
- [Testing Guide](docs/testing-guide.md)
|
|
951
|
-
- [Keyboard Shortcuts](docs/keyboard-shortcuts.md)
|
|
952
|
-
- [Full Documentation](https://smartaimemory.com/framework-docs/)
|
|
953
|
-
|
|
954
|
-
---
|
|
955
|
-
|
|
956
659
|
## Security
|
|
957
660
|
|
|
958
661
|
- Path traversal protection on all file operations
|
|
959
662
|
- JWT authentication with rate limiting
|
|
960
663
|
- PII scrubbing in telemetry
|
|
961
664
|
- HIPAA/GDPR compliance options
|
|
962
|
-
-
|
|
963
|
-
|
|
964
|
-
See [SECURITY.md](SECURITY.md) for vulnerability reporting.
|
|
965
|
-
|
|
966
|
-
### Security Scanning
|
|
967
|
-
|
|
968
|
-
**Automated security scanning in CI/CD** - 82% accuracy, blocks critical issues:
|
|
665
|
+
- Automated security scanning with 82% accuracy
|
|
969
666
|
|
|
970
667
|
```bash
|
|
971
|
-
# Run security audit
|
|
972
|
-
|
|
973
|
-
|
|
974
|
-
# Scan specific directory
|
|
975
|
-
empathy workflow run security-audit --input '{"path":"./src"}'
|
|
668
|
+
# Run security audit
|
|
669
|
+
attune workflow run security-audit --path ./src
|
|
976
670
|
```
|
|
977
671
|
|
|
978
|
-
|
|
672
|
+
See [SECURITY.md](SECURITY.md) for vulnerability reporting.
|
|
979
673
|
|
|
980
|
-
|
|
981
|
-
- **[CI/CD Integration Guide](docs/CI_SECURITY_SCANNING.md)** - Complete setup and troubleshooting (DevOps, developers)
|
|
982
|
-
- **[Scanner Architecture](docs/SECURITY_SCANNER_ARCHITECTURE.md)** - Technical implementation details (engineers, architects)
|
|
983
|
-
- **[Remediation Process](docs/SECURITY_REMEDIATION_PROCESS.md)** - 3-phase methodology for improving scanners (security teams, leadership)
|
|
984
|
-
- **[API Reference](docs/api-reference/security-scanner.md)** - Complete API documentation (developers extending scanner)
|
|
674
|
+
---
|
|
985
675
|
|
|
986
|
-
|
|
676
|
+
## Documentation
|
|
987
677
|
|
|
988
|
-
-
|
|
989
|
-
-
|
|
990
|
-
-
|
|
991
|
-
-
|
|
678
|
+
- [Quick Start Guide](docs/quickstart.md)
|
|
679
|
+
- [CLI Reference](docs/cli-reference.md)
|
|
680
|
+
- [Authentication Strategy Guide](docs/AUTH_STRATEGY_GUIDE.md)
|
|
681
|
+
- [Full Documentation](https://smartaimemory.com/framework-docs/)
|
|
992
682
|
|
|
993
683
|
---
|
|
994
684
|
|
|
@@ -1000,27 +690,20 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
|
|
|
1000
690
|
|
|
1001
691
|
## License
|
|
1002
692
|
|
|
1003
|
-
**Apache License 2.0** - Free and open source
|
|
693
|
+
**Apache License 2.0** - Free and open source. Use it, modify it, build commercial products with it. [Details →](LICENSE)
|
|
1004
694
|
|
|
1005
695
|
---
|
|
1006
696
|
|
|
1007
697
|
## Acknowledgements
|
|
1008
698
|
|
|
1009
|
-
This project stands on the shoulders of giants. We are deeply grateful to the open source community and all the amazing projects that make this framework possible.
|
|
1010
|
-
|
|
1011
|
-
**[View Full Acknowledgements →](ACKNOWLEDGEMENTS.md)**
|
|
1012
|
-
|
|
1013
699
|
Special thanks to:
|
|
1014
700
|
|
|
1015
701
|
- **[Anthropic](https://www.anthropic.com/)** - For Claude AI and the Model Context Protocol
|
|
1016
|
-
- **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our
|
|
702
|
+
- **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our orchestration
|
|
1017
703
|
- **[FastAPI](https://github.com/tiangolo/fastapi)** - Modern Python web framework
|
|
1018
|
-
- **[pytest](https://github.com/pytest-dev/pytest)** - Testing framework making quality assurance effortless
|
|
1019
|
-
|
|
1020
|
-
And to all 50+ open source projects we depend on. [See the complete list →](ACKNOWLEDGEMENTS.md)
|
|
1021
704
|
|
|
1022
|
-
|
|
705
|
+
[View Full Acknowledgements →](ACKNOWLEDGEMENTS.md)
|
|
1023
706
|
|
|
1024
707
|
---
|
|
1025
708
|
|
|
1026
|
-
**Built by [Smart AI Memory](https://smartaimemory.com)** · [Docs](https://smartaimemory.com/framework-docs/) · [
|
|
709
|
+
**Built by [Smart AI Memory](https://smartaimemory.com)** · [Docs](https://smartaimemory.com/framework-docs/) · [Issues](https://github.com/Smart-AI-Memory/attune-ai/issues)
|
|
@@ -347,8 +347,8 @@ attune/workflows/test_gen/data_models.py,sha256=wXfef60ptiG6AvygayTxWqlL5FVOss19
|
|
|
347
347
|
attune/workflows/test_gen/report_formatter.py,sha256=RaxbDp6-9iQRfJmVwrrIReVkOkrnb668NgHrNaS-SPY,10705
|
|
348
348
|
attune/workflows/test_gen/test_templates.py,sha256=4ywqGYYaSoZxOU6Y1_E-27KEgMI5-v2a1ndia406E9c,13180
|
|
349
349
|
attune/workflows/test_gen/workflow.py,sha256=U0dhAcCKmlltPIvCSXUeFzt_Q4TodQI4tXtR6cz19MQ,25729
|
|
350
|
-
attune_ai-2.1.
|
|
351
|
-
attune_ai-2.1.
|
|
350
|
+
attune_ai-2.1.3.dist-info/licenses/LICENSE,sha256=kqe3EeGatNB79lUTHxjLnxDe7VJr0iYetThOr4_Fx7A,11348
|
|
351
|
+
attune_ai-2.1.3.dist-info/licenses/LICENSE_CHANGE_ANNOUNCEMENT.md,sha256=JH9yAQGv_lQej5YlztI_kawbVQ2H8uVLhPGlrWnR_34,3844
|
|
352
352
|
attune_healthcare/__init__.py,sha256=4NioL1_86UXzkd-QNkQZUSZ8rKTQGSP0TC9VXP32kQs,295
|
|
353
353
|
attune_healthcare/monitors/__init__.py,sha256=Udp8qfZR504QAq5_eQjvtIaE7v06Yguc7nuF40KllQc,196
|
|
354
354
|
attune_healthcare/monitors/clinical_protocol_monitor.py,sha256=MWE5t8tW9HWZn_SNo-inx8-0nhdTNGhbcB8ZeDWyXa0,11648
|
|
@@ -450,8 +450,8 @@ workflow_scaffolding/__init__.py,sha256=UpX5vjjjPjIaAKyIV1D4GxJzLUZy5DzdzgSkePYM
|
|
|
450
450
|
workflow_scaffolding/__main__.py,sha256=0qspuNoadTDqyskXTlT8Sahqau-XIxN35NHTSGVW6z4,236
|
|
451
451
|
workflow_scaffolding/cli.py,sha256=RUVqU9SeAgm7YkM0YNd-quh8u6BNzmX8xM2y9K_p68Y,6759
|
|
452
452
|
workflow_scaffolding/generator.py,sha256=2WC02A10lzF2NQgOn66ksV17Oe72kKlU2qCQs39LIlw,8861
|
|
453
|
-
attune_ai-2.1.
|
|
454
|
-
attune_ai-2.1.
|
|
455
|
-
attune_ai-2.1.
|
|
456
|
-
attune_ai-2.1.
|
|
457
|
-
attune_ai-2.1.
|
|
453
|
+
attune_ai-2.1.3.dist-info/METADATA,sha256=sCt_8yu13CtsXc3fhY4aqyBNZgiWLVO8GtQ4yF-rXM0,33764
|
|
454
|
+
attune_ai-2.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
|
|
455
|
+
attune_ai-2.1.3.dist-info/entry_points.txt,sha256=GVlb04zFlpkaPtaL7X3JCZI8R0AEOZRsZjJ-wIDQvdo,1458
|
|
456
|
+
attune_ai-2.1.3.dist-info/top_level.txt,sha256=iLyjKpuOzWtwmIOZqzeBh8_SVztY2vFvhHcyo1WPtTY,73
|
|
457
|
+
attune_ai-2.1.3.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{attune_ai-2.1.2.dist-info → attune_ai-2.1.3.dist-info}/licenses/LICENSE_CHANGE_ANNOUNCEMENT.md
RENAMED
|
File without changes
|
|
File without changes
|