vibe-engineering 0.1.7__tar.gz

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.
@@ -0,0 +1,262 @@
1
+ Metadata-Version: 2.4
2
+ Name: vibe-engineering
3
+ Version: 0.1.7
4
+ Summary: Add your description here
5
+ Home-page: https://github.com/vibeengineering/vibe-engineering
6
+ Author: Vibe Engineering Team
7
+ Author-email: team@vibeengineering.com
8
+ Requires-Python: >=3.10
9
+ Description-Content-Type: text/markdown
10
+ Requires-Dist: certifi>=2024.12.14
11
+ Requires-Dist: fireworks-ai>=0.19.19
12
+ Requires-Dist: pydantic>=2.12.0
13
+ Requires-Dist: pymongo>=4.15.3
14
+ Requires-Dist: python-dotenv>=1.1.1
15
+ Requires-Dist: requests>=2.32.0
16
+ Requires-Dist: rich>=14.2.0
17
+ Requires-Dist: typer>=0.19.2
18
+ Dynamic: author
19
+ Dynamic: author-email
20
+ Dynamic: home-page
21
+ Dynamic: requires-python
22
+
23
+ # 🚀 Vibe Engineering CLI
24
+
25
+ [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
26
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
27
+ [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
28
+
29
+ > **AI-powered specification and memory management CLI for modern development teams**
30
+
31
+ Vibe Engineering is a powerful command-line tool that helps development teams manage specifications, project knowledge, and development workflows using AI assistance. Built with VoyageAI embeddings and MongoDB vector search for intelligent document management.
32
+
33
+ ## ✨ Features
34
+
35
+ - 🤖 **AI-Powered Specifications** - Generate detailed specs using advanced LLMs
36
+ - 🧠 **Memory Management** - Store and retrieve project knowledge with vector search
37
+ - 👥 **Team Collaboration** - Track team members and project ownership
38
+ - 📊 **Rich CLI Experience** - Beautiful, interactive command-line interface
39
+ - 🔍 **Vector Search** - Find relevant information using semantic similarity
40
+ - 📝 **Multiple Formats** - Export specifications in JSON, YAML, and Markdown
41
+
42
+ ## 🚀 Quick Install
43
+
44
+ ### PowerShell (Windows)
45
+ ```powershell
46
+ PowerShell -ExecutionPolicy Bypass -Command "iwr -useb https://raw.githubusercontent.com/vibeengineering/vibe-engineering/main/install.ps1 | iex"
47
+ ```
48
+
49
+ ### Bash (Linux/macOS)
50
+ ```bash
51
+ curl -sSL https://raw.githubusercontent.com/vibeengineering/vibe-engineering/main/install.sh | bash
52
+ ```
53
+
54
+ ### Manual Installation
55
+ ```bash
56
+ # Clone the repository
57
+ git clone https://github.com/vibeengineering/vibe-engineering.git
58
+ cd vibe-engineering
59
+
60
+ # Install dependencies
61
+ pip install -r requirements.txt
62
+
63
+ # Install the CLI
64
+ pip install -e .
65
+
66
+ # Setup configuration
67
+ cp .env.dist .env
68
+ # Edit .env with your API keys
69
+ ```
70
+
71
+ ## ⚙️ Configuration
72
+
73
+ 1. **Copy environment template:**
74
+ ```bash
75
+ cp .env.dist .env
76
+ ```
77
+
78
+ 2. **Configure your API keys in `.env`:**
79
+ ```bash
80
+ # VoyageAI Configuration
81
+ VOYAGE_API_KEY=your_voyage_api_key_here
82
+ VOYAGE_MODEL=voyage-2
83
+
84
+ # MongoDB Configuration
85
+ MONGODB_URI=your_mongodb_connection_string
86
+ MONGO_DB=your_database_name
87
+ MONGO_COLLECTION=memories
88
+
89
+ # Fireworks AI Configuration
90
+ FIREWORKS_API_KEY=your_fireworks_api_key_here
91
+ FIREWORKS_MODEL=accounts/fireworks/models/llama-v3p1-70b-instruct
92
+ ```
93
+
94
+ ## 📖 Usage
95
+
96
+ ### Basic Commands
97
+
98
+ ```bash
99
+ # Show system status
100
+ vibe status
101
+
102
+ # Display team members
103
+ vibe team
104
+
105
+ # Generate AI specification
106
+ vibe specify "Create a user authentication system"
107
+
108
+ # Show version
109
+ vibe version
110
+
111
+ # Get help
112
+ vibe --help
113
+ ```
114
+
115
+ ### Advanced Usage
116
+
117
+ ```bash
118
+ # Generate specification with options
119
+ vibe specify "Add payment processing" --format json --save --verbose
120
+
121
+ # Custom output formats
122
+ vibe specify "User dashboard" --format markdown
123
+
124
+ # Save specification to database
125
+ vibe specify "API rate limiting" --save
126
+ ```
127
+
128
+ ## 📋 Commands Reference
129
+
130
+ | Command | Description | Example |
131
+ |---------|-------------|---------|
132
+ | `vibe status` | 🔍 Show system status and configuration | `vibe status` |
133
+ | `vibe team` | 👥 Display team members from database | `vibe team` |
134
+ | `vibe specify` | ✨ Generate AI-powered specifications | `vibe specify "Add user auth"` |
135
+ | `vibe version` | 📦 Show version information | `vibe version` |
136
+
137
+ ### Specify Command Options
138
+
139
+ ```bash
140
+ vibe specify PROMPT [OPTIONS]
141
+
142
+ Options:
143
+ -f, --format Output format: json, yaml, markdown (default: json)
144
+ -s, --save Save specification to database
145
+ -v, --verbose Show detailed output
146
+ --help Show help message
147
+ ```
148
+
149
+ ## 🏗️ Architecture
150
+
151
+ ```
152
+ ├── src/
153
+ │ ├── cli/ # Command-line interface
154
+ │ ├── db/ # Database operations (MongoDB)
155
+ │ ├── llm/ # LLM clients (Fireworks, VoyageAI)
156
+ │ └── schemas/ # Data models and schemas
157
+ ├── install.ps1 # PowerShell installer
158
+ ├── install.sh # Bash installer
159
+ ├── setup.py # Python package setup
160
+ └── requirements.txt # Dependencies
161
+ ```
162
+
163
+ ## 🛠️ Development
164
+
165
+ ### Prerequisites
166
+ - Python 3.10+
167
+ - MongoDB (Atlas or local)
168
+ - VoyageAI API key
169
+ - Fireworks AI API key
170
+
171
+ ### Setup Development Environment
172
+
173
+ ```bash
174
+ # Clone repository
175
+ git clone https://github.com/vibeengineering/vibe-engineering.git
176
+ cd vibe-engineering
177
+
178
+ # Install development dependencies
179
+ pip install -r requirements-dev.txt
180
+
181
+ # Install in development mode
182
+ pip install -e .
183
+
184
+ # Run tests
185
+ pytest
186
+
187
+ # Format code
188
+ black .
189
+
190
+ # Type checking
191
+ mypy src/
192
+ ```
193
+
194
+ ### Running Locally
195
+
196
+ ```bash
197
+ # Run CLI directly
198
+ python -m src.cli --help
199
+
200
+ # Or use the installed command
201
+ vibe --help
202
+ ```
203
+
204
+ ## 🔧 Configuration Options
205
+
206
+ ### Environment Variables
207
+
208
+ | Variable | Description | Default |
209
+ |----------|-------------|---------|
210
+ | `VOYAGE_API_KEY` | VoyageAI API key for embeddings | Required |
211
+ | `VOYAGE_MODEL` | VoyageAI model to use | `voyage-2` |
212
+ | `MONGODB_URI` | MongoDB connection string | Required |
213
+ | `MONGO_DB` | Database name | `master` |
214
+ | `MONGO_COLLECTION` | Collection name | `memories` |
215
+ | `FIREWORKS_API_KEY` | Fireworks AI API key | Required |
216
+ | `FIREWORKS_MODEL` | Fireworks model to use | `llama-v3p1-70b-instruct` |
217
+
218
+ ## 🚦 System Requirements
219
+
220
+ - **Python**: 3.10 or higher
221
+ - **Memory**: 512MB RAM minimum
222
+ - **Storage**: 100MB free space
223
+ - **Network**: Internet connection for AI APIs
224
+ - **Database**: MongoDB Atlas or local MongoDB instance
225
+
226
+ ## 📚 Documentation
227
+
228
+ - [Installation Guide](./docs/installation.md)
229
+ - [Configuration Reference](./docs/configuration.md)
230
+ - [API Documentation](./docs/api.md)
231
+ - [Contributing Guide](./CONTRIBUTING.md)
232
+
233
+ ## 🤝 Contributing
234
+
235
+ We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.
236
+
237
+ 1. Fork the repository
238
+ 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
239
+ 3. Commit your changes (`git commit -m 'Add amazing feature'`)
240
+ 4. Push to the branch (`git push origin feature/amazing-feature`)
241
+ 5. Open a Pull Request
242
+
243
+ ## 📄 License
244
+
245
+ This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
246
+
247
+ ## 🆘 Support
248
+
249
+ - 📧 Email: support@vibeengineering.com
250
+ - 💬 GitHub Issues: [Create an issue](https://github.com/vibeengineering/vibe-engineering/issues)
251
+ - 📖 Documentation: [Read the docs](https://docs.vibeengineering.com)
252
+
253
+ ## 🙏 Acknowledgments
254
+
255
+ - Built with [Typer](https://typer.tiangolo.com/) for the CLI framework
256
+ - Powered by [VoyageAI](https://www.voyageai.com/) for embeddings
257
+ - Uses [Fireworks AI](https://fireworks.ai/) for LLM capabilities
258
+ - Styled with [Rich](https://rich.readthedocs.io/) for beautiful terminal output
259
+
260
+ ---
261
+
262
+ **Made with ❤️ by the Vibe Engineering Team**
@@ -0,0 +1,240 @@
1
+ # 🚀 Vibe Engineering CLI
2
+
3
+ [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+ [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
6
+
7
+ > **AI-powered specification and memory management CLI for modern development teams**
8
+
9
+ Vibe Engineering is a powerful command-line tool that helps development teams manage specifications, project knowledge, and development workflows using AI assistance. Built with VoyageAI embeddings and MongoDB vector search for intelligent document management.
10
+
11
+ ## ✨ Features
12
+
13
+ - 🤖 **AI-Powered Specifications** - Generate detailed specs using advanced LLMs
14
+ - 🧠 **Memory Management** - Store and retrieve project knowledge with vector search
15
+ - 👥 **Team Collaboration** - Track team members and project ownership
16
+ - 📊 **Rich CLI Experience** - Beautiful, interactive command-line interface
17
+ - 🔍 **Vector Search** - Find relevant information using semantic similarity
18
+ - 📝 **Multiple Formats** - Export specifications in JSON, YAML, and Markdown
19
+
20
+ ## 🚀 Quick Install
21
+
22
+ ### PowerShell (Windows)
23
+ ```powershell
24
+ PowerShell -ExecutionPolicy Bypass -Command "iwr -useb https://raw.githubusercontent.com/vibeengineering/vibe-engineering/main/install.ps1 | iex"
25
+ ```
26
+
27
+ ### Bash (Linux/macOS)
28
+ ```bash
29
+ curl -sSL https://raw.githubusercontent.com/vibeengineering/vibe-engineering/main/install.sh | bash
30
+ ```
31
+
32
+ ### Manual Installation
33
+ ```bash
34
+ # Clone the repository
35
+ git clone https://github.com/vibeengineering/vibe-engineering.git
36
+ cd vibe-engineering
37
+
38
+ # Install dependencies
39
+ pip install -r requirements.txt
40
+
41
+ # Install the CLI
42
+ pip install -e .
43
+
44
+ # Setup configuration
45
+ cp .env.dist .env
46
+ # Edit .env with your API keys
47
+ ```
48
+
49
+ ## ⚙️ Configuration
50
+
51
+ 1. **Copy environment template:**
52
+ ```bash
53
+ cp .env.dist .env
54
+ ```
55
+
56
+ 2. **Configure your API keys in `.env`:**
57
+ ```bash
58
+ # VoyageAI Configuration
59
+ VOYAGE_API_KEY=your_voyage_api_key_here
60
+ VOYAGE_MODEL=voyage-2
61
+
62
+ # MongoDB Configuration
63
+ MONGODB_URI=your_mongodb_connection_string
64
+ MONGO_DB=your_database_name
65
+ MONGO_COLLECTION=memories
66
+
67
+ # Fireworks AI Configuration
68
+ FIREWORKS_API_KEY=your_fireworks_api_key_here
69
+ FIREWORKS_MODEL=accounts/fireworks/models/llama-v3p1-70b-instruct
70
+ ```
71
+
72
+ ## 📖 Usage
73
+
74
+ ### Basic Commands
75
+
76
+ ```bash
77
+ # Show system status
78
+ vibe status
79
+
80
+ # Display team members
81
+ vibe team
82
+
83
+ # Generate AI specification
84
+ vibe specify "Create a user authentication system"
85
+
86
+ # Show version
87
+ vibe version
88
+
89
+ # Get help
90
+ vibe --help
91
+ ```
92
+
93
+ ### Advanced Usage
94
+
95
+ ```bash
96
+ # Generate specification with options
97
+ vibe specify "Add payment processing" --format json --save --verbose
98
+
99
+ # Custom output formats
100
+ vibe specify "User dashboard" --format markdown
101
+
102
+ # Save specification to database
103
+ vibe specify "API rate limiting" --save
104
+ ```
105
+
106
+ ## 📋 Commands Reference
107
+
108
+ | Command | Description | Example |
109
+ |---------|-------------|---------|
110
+ | `vibe status` | 🔍 Show system status and configuration | `vibe status` |
111
+ | `vibe team` | 👥 Display team members from database | `vibe team` |
112
+ | `vibe specify` | ✨ Generate AI-powered specifications | `vibe specify "Add user auth"` |
113
+ | `vibe version` | 📦 Show version information | `vibe version` |
114
+
115
+ ### Specify Command Options
116
+
117
+ ```bash
118
+ vibe specify PROMPT [OPTIONS]
119
+
120
+ Options:
121
+ -f, --format Output format: json, yaml, markdown (default: json)
122
+ -s, --save Save specification to database
123
+ -v, --verbose Show detailed output
124
+ --help Show help message
125
+ ```
126
+
127
+ ## 🏗️ Architecture
128
+
129
+ ```
130
+ ├── src/
131
+ │ ├── cli/ # Command-line interface
132
+ │ ├── db/ # Database operations (MongoDB)
133
+ │ ├── llm/ # LLM clients (Fireworks, VoyageAI)
134
+ │ └── schemas/ # Data models and schemas
135
+ ├── install.ps1 # PowerShell installer
136
+ ├── install.sh # Bash installer
137
+ ├── setup.py # Python package setup
138
+ └── requirements.txt # Dependencies
139
+ ```
140
+
141
+ ## 🛠️ Development
142
+
143
+ ### Prerequisites
144
+ - Python 3.10+
145
+ - MongoDB (Atlas or local)
146
+ - VoyageAI API key
147
+ - Fireworks AI API key
148
+
149
+ ### Setup Development Environment
150
+
151
+ ```bash
152
+ # Clone repository
153
+ git clone https://github.com/vibeengineering/vibe-engineering.git
154
+ cd vibe-engineering
155
+
156
+ # Install development dependencies
157
+ pip install -r requirements-dev.txt
158
+
159
+ # Install in development mode
160
+ pip install -e .
161
+
162
+ # Run tests
163
+ pytest
164
+
165
+ # Format code
166
+ black .
167
+
168
+ # Type checking
169
+ mypy src/
170
+ ```
171
+
172
+ ### Running Locally
173
+
174
+ ```bash
175
+ # Run CLI directly
176
+ python -m src.cli --help
177
+
178
+ # Or use the installed command
179
+ vibe --help
180
+ ```
181
+
182
+ ## 🔧 Configuration Options
183
+
184
+ ### Environment Variables
185
+
186
+ | Variable | Description | Default |
187
+ |----------|-------------|---------|
188
+ | `VOYAGE_API_KEY` | VoyageAI API key for embeddings | Required |
189
+ | `VOYAGE_MODEL` | VoyageAI model to use | `voyage-2` |
190
+ | `MONGODB_URI` | MongoDB connection string | Required |
191
+ | `MONGO_DB` | Database name | `master` |
192
+ | `MONGO_COLLECTION` | Collection name | `memories` |
193
+ | `FIREWORKS_API_KEY` | Fireworks AI API key | Required |
194
+ | `FIREWORKS_MODEL` | Fireworks model to use | `llama-v3p1-70b-instruct` |
195
+
196
+ ## 🚦 System Requirements
197
+
198
+ - **Python**: 3.10 or higher
199
+ - **Memory**: 512MB RAM minimum
200
+ - **Storage**: 100MB free space
201
+ - **Network**: Internet connection for AI APIs
202
+ - **Database**: MongoDB Atlas or local MongoDB instance
203
+
204
+ ## 📚 Documentation
205
+
206
+ - [Installation Guide](./docs/installation.md)
207
+ - [Configuration Reference](./docs/configuration.md)
208
+ - [API Documentation](./docs/api.md)
209
+ - [Contributing Guide](./CONTRIBUTING.md)
210
+
211
+ ## 🤝 Contributing
212
+
213
+ We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.
214
+
215
+ 1. Fork the repository
216
+ 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
217
+ 3. Commit your changes (`git commit -m 'Add amazing feature'`)
218
+ 4. Push to the branch (`git push origin feature/amazing-feature`)
219
+ 5. Open a Pull Request
220
+
221
+ ## 📄 License
222
+
223
+ This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
224
+
225
+ ## 🆘 Support
226
+
227
+ - 📧 Email: support@vibeengineering.com
228
+ - 💬 GitHub Issues: [Create an issue](https://github.com/vibeengineering/vibe-engineering/issues)
229
+ - 📖 Documentation: [Read the docs](https://docs.vibeengineering.com)
230
+
231
+ ## 🙏 Acknowledgments
232
+
233
+ - Built with [Typer](https://typer.tiangolo.com/) for the CLI framework
234
+ - Powered by [VoyageAI](https://www.voyageai.com/) for embeddings
235
+ - Uses [Fireworks AI](https://fireworks.ai/) for LLM capabilities
236
+ - Styled with [Rich](https://rich.readthedocs.io/) for beautiful terminal output
237
+
238
+ ---
239
+
240
+ **Made with ❤️ by the Vibe Engineering Team**
@@ -0,0 +1,16 @@
1
+ [project]
2
+ name = "vibe-engineering"
3
+ version = "0.1.7"
4
+ description = "Add your description here"
5
+ readme = "README.md"
6
+ requires-python = ">=3.13"
7
+ dependencies = [
8
+ "certifi>=2024.12.14",
9
+ "fireworks-ai>=0.19.19",
10
+ "pydantic>=2.12.0",
11
+ "pymongo>=4.15.3",
12
+ "python-dotenv>=1.1.1",
13
+ "requests>=2.32.0",
14
+ "rich>=14.2.0",
15
+ "typer>=0.19.2",
16
+ ]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,74 @@
1
+ #!/usr/bin/env python3
2
+ """Setup script for vibe-engineering CLI."""
3
+
4
+ from setuptools import setup, find_packages
5
+ import os
6
+
7
+ # Read the README file
8
+ def read_readme():
9
+ with open("README.md", "r", encoding="utf-8") as f:
10
+ return f.read()
11
+
12
+ # Read requirements
13
+ def read_requirements():
14
+ requirements = []
15
+ if os.path.exists("requirements.txt"):
16
+ with open("requirements.txt", "r") as f:
17
+ requirements = [line.strip() for line in f if line.strip() and not line.startswith("#")]
18
+ return requirements
19
+
20
+ setup(
21
+ name="vibe-engineering",
22
+ version="0.1.7",
23
+ description="A CLI tool for managing specifications with VoyageAI embeddings and MongoDB vector search",
24
+ long_description=read_readme(),
25
+ long_description_content_type="text/markdown",
26
+ author="Vibe Engineering Team",
27
+ author_email="team@vibeengineering.com",
28
+ url="https://github.com/vibeengineering/vibe-engineering",
29
+ packages=find_packages(),
30
+ include_package_data=True,
31
+ install_requires=[
32
+ "certifi>=2024.12.14",
33
+ "fireworks-ai>=0.19.19",
34
+ "pydantic>=2.12.0",
35
+ "pymongo>=4.15.3",
36
+ "python-dotenv>=1.1.1",
37
+ "requests>=2.32.0",
38
+ "rich>=14.2.0",
39
+ "typer>=0.19.2",
40
+ "voyageai>=0.2.0",
41
+ ],
42
+ extras_require={
43
+ "dev": [
44
+ "pytest>=7.0.0",
45
+ "black>=22.0.0",
46
+ "flake8>=4.0.0",
47
+ "mypy>=0.950",
48
+ ]
49
+ },
50
+ entry_points={
51
+ "console_scripts": [
52
+ "vibe=src.cli:app",
53
+ "vibe-engineering=src.cli:app",
54
+ ],
55
+ },
56
+ classifiers=[
57
+ "Development Status :: 3 - Alpha",
58
+ "Intended Audience :: Developers",
59
+ "License :: OSI Approved :: MIT License",
60
+ "Operating System :: OS Independent",
61
+ "Programming Language :: Python :: 3",
62
+ "Programming Language :: Python :: 3.10",
63
+ "Programming Language :: Python :: 3.11",
64
+ "Programming Language :: Python :: 3.12",
65
+ "Programming Language :: Python :: 3.13",
66
+ ],
67
+ python_requires=">=3.10",
68
+ keywords="cli, specifications, ai, mongodb, vector-search, documentation",
69
+ project_urls={
70
+ "Bug Reports": "https://github.com/vibeengineering/vibe-engineering/issues",
71
+ "Source": "https://github.com/vibeengineering/vibe-engineering",
72
+ "Documentation": "https://github.com/vibeengineering/vibe-engineering#readme",
73
+ },
74
+ )
File without changes
@@ -0,0 +1,4 @@
1
+ """CLI module for command-line interface."""
2
+ from .commands import app
3
+
4
+ __all__ = ["app"]