https://github.com/2501-ai/cli
Your AI-powered autonomous agent that codes, interacts with your infrastructure and development workflows
https://github.com/2501-ai/cli
agentic agentic-ai agentic-workflow ai autonomous rag
Last synced: about 1 month ago
JSON representation
Your AI-powered autonomous agent that codes, interacts with your infrastructure and development workflows
- Host: GitHub
- URL: https://github.com/2501-ai/cli
- Owner: 2501-ai
- License: other
- Created: 2024-03-24T08:08:57.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-06T11:26:21.000Z (about 1 month ago)
- Last Synced: 2025-05-06T19:13:03.565Z (about 1 month ago)
- Topics: agentic, agentic-ai, agentic-workflow, ai, autonomous, rag
- Language: TypeScript
- Homepage: https://2501.ai
- Size: 8.11 MB
- Stars: 9
- Watchers: 0
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 2501 CLI 🤖
[](https://www.npmjs.com/package/@2501-ai/cli)
[](https://www.2501.ai/research/full-humaneval-benchmark)
[](LICENSE)
[](https://discord.gg/DYC8ryeC7e)
Your AI-powered autonomous agent that codes, interacts with your infrastructure and development workflows.
Whether you're debugging production issues, automating DevOps tasks, or seeking coding assistance, 2501 CLI brings the power of multiple specialized autonomous agents directly to your terminal.
## 🚀 Getting Started
1. **Install the CLI:**
```bash
npm install -g @2501-ai/cli
```
2. **Set up your API key:**
- Get your API key at [accounts.2501.ai](https://accounts.2501.ai)
- Configure the CLI:
```bash
@2501 set api_key YOUR_API_KEY
```
3. **Supercharge your terminal:**
```bash
@2501 Implement authentication in my express app
```
## 🤔 Why 2501?
- 🎯 **Unmatched Accuracy**: 96.95% success rate on HumanEval, setting a new industry standard. Check out our [benchmark](https://2501-ai.webflow.io/blog/full-humaneval-benchmark) for more details
- 🧠 **Multi-Model Intelligence**: Unlike single-model solutions, 2501 leverages multiple specialized models
- 🔍 **Context-Aware**: Understands your project structure and coding patterns
- ✅ **Self-Validating**: Eliminates hallucinations through multi-model verification
- ⚡ **Fast & Efficient** - Get answers directly in your terminal
- 🛠️ **Workspace Aware** - Understands your project context
## 🧠 How It Works
At the heart of 2501 is an orchestration of multiple of the top-performing models on the market today. Our approach, referenced as MoM (or Mixture of Models) going forward, is designed to maximize the successful execution of coding projects derived from natural language instructions.
With no one-size-fits-all model available, output quality is highly task-dependent. Our approach is to decompose any complex software development requirements into bite-sized tasks that can then be assigned to the most suitable model for resolution.
That’s precisely why the MoM approach shines and 2501’s autonomy does not stop here. On top of that, we continually evaluate the resolution of each task with a second model to improve or fix potential hallucinations.
## 📊 Comparison with Other Solutions
| Feature | 2501 | GitHub Copilot | Other AI Assistants |
| -------------------- | ------ | ------------------------------------------------- | --------------------------------------------------------- |
| HumanEval Score | 96.95% | [~48.1%](https://cdn.openai.com/papers/gpt-4.pdf) | [~90%](https://artificialanalysis.ai/leaderboards/models) |
| Multi-Model Approach | ✅ | ❌ | ❌ |
| Self-Validation | ✅ | ❌ | ❌ |
| Workspace Awareness | ✅ | ✅ | Varies |
| Terminal Integration | ✅ | ❌ | Varies |
## 💻 System Requirements
- Node.js 16.x or higher
## Commands
### Set Command
- Description: Set configuration values.
- Usage: `@2501 set `
- `api_key`: Set the API key retrieved from the 2501 desktop app.
### Config Command
- Description: Fetches available agentic configurations from the API.
- Usage: `@2501 config`
### Query Command
- Description: Execute a query using the specified agent.
- Common usage: `@2501 Implement authentication in my express app`
- This will execute the query using the agent assigned to the current workspace.
- Custom Usage: `@2501 query [--workspace ] [--agentId ]`
### Init Command
- Description: Initializes a new agent.
- Usage: `@2501 init [--name ] [--workspace ] [--config ]`
### Agents Command
- Description: List agents in the current workspace or all agents on the machine.
- Usage: `@2501 agents [--workspace ] [--all] [--flush]`
### Jobs Command
- Description: Fetch jobs from API.
- Usage: `@2501 jobs [--workspace ] [--subscribe] [--listen]`
- `--workspace `: Specify a different workspace path.
- `--subscribe`: Subscribe every minute to the API for new jobs on the current workspace.
- `--unsubscribe`: Unsubscribe the current workspace for new jobs.
- `--listen`: Listen for new jobs from the API and execute them.
## 🤝 Contributing
We welcome contributions! Have questions or suggestions? Reach out to us:
- 🌐 Website: [2501.ai](https://2501.ai)
- 📧 Email: [[email protected]](mailto:[email protected])
- 📚 Documentation: [docs.2501.ai](https://docs.2501.ai)
- 💬 Discord: [Join our community](https://discord.gg/DYC8ryeC7e)
## 🔒 Security
Found a security issue? Please email [email protected]
## 📄 License
This project is licensed under the ISC License - see the [LICENSE](LICENSE) file for details.