sparc  by ruvnet

CLI tool for AI-assisted software development using the SPARC framework

created 9 months ago
346 stars

Top 81.3% on sourcepulse

GitHubView on GitHub
Project Summary

The SPARC Framework is a comprehensive methodology for developing robust and scalable applications, targeting software engineers and teams seeking a structured, AI-assisted development process. It aims to enhance quality, collaboration, and intelligent evolution through a defined five-step lifecycle.

How It Works

SPARC guides development through Specification, Pseudocode, Architecture, Refinement, and Completion. It integrates advanced AI tools like Perplexity for research and AIDER.chat for coding, leveraging symbolic reasoning and "pseudo consciousness" for enhanced decision-making and self-improvement. The framework emphasizes documentation, reflective practices, and adaptive optimization.

Quick Start & Requirements

  • Install from PyPI: pip install sparc
  • Requires Python 3.8+
  • API keys for LLM providers (Anthropic, OpenAI, OpenRouter) must be configured via environment variables (.env file).
  • Official documentation and example project available.

Highlighted Details

  • SPARC CLI (v0.87.7) offers AI-assisted development with autonomous research and implementation capabilities.
  • Supports multiple LLM providers (Anthropic, OpenAI, OpenRouter) and models.
  • Features human-in-the-loop controls and an optional "cowboy mode" for autonomous shell command execution.
  • Integrates PolarisOne for enhanced token weighting, memory management, and context-aware development.
  • Includes a tool system for file operations, directory navigation, shell commands, research, and web scraping (via Scape tool).

Maintenance & Community

  • Contributions are welcomed via pull requests.
  • Project acknowledges contributions from Perplexity, AIDER.chat, OpenAI, RA.Aid, Playwright, and Langchain.

Licensing & Compatibility

  • Licensed under the Apache 2 License.
  • Permissive license suitable for commercial use and integration with closed-source projects.

Limitations & Caveats

The tool executes shell commands and makes code changes, with a strong warning to use at your own risk, especially in version-controlled repositories. The "cowboy mode" bypasses approval prompts for shell commands.

Health Check
Last commit

6 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
126 stars in the last 90 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Jeff Hammerbacher Jeff Hammerbacher(Cofounder of Cloudera), and
9 more.

codex by openai

0.8%
32k
Coding agent CLI tool for terminal-based chat-driven development
created 3 months ago
updated 18 hours ago
Feedback? Help us improve.