lwazi 1.0.0

package/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 Lwazi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This package uses Ollama (https://ollama.com) which is licensed under the MIT License.

package/README.md

@@ -0,0 +1,187 @@
+# Lwazi AI Assistant
+
+[![npm version](https://badge.fury.io/js/lwazi-ai.svg)](https://badge.fury.io/js/lwazi-ai)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**AI-powered assistant for Laravel applications.** Add an intelligent chat widget to your Laravel app with just one command.
+
+## Features
+
+- 🤖 **AI-Powered Chat**: Integrates with Ollama for local AI conversations
+- 🎨 **Customizable UI**: Modern chat widget with theme customization
+- 🔍 **Smart Navigation**: AI understands your app structure and helps users navigate
+- 📱 **Responsive Design**: Works on desktop and mobile
+- ⚡ **Easy Installation**: One-command setup for Laravel projects
+- 🔒 **Privacy-Focused**: Runs locally with Ollama, no external API calls
+
+## Quick Start
+
+### Prerequisites
+
+- **Laravel 10+** application
+- **PHP 8.1+**
+- **Node.js 14+** (for installation)
+- **Ollama** running locally
+
+### Installation
+
+```bash
+# Install via npm
+npm install lwazi-ai
+
+# This will automatically run the post-install script
+# Then complete the installation by running:
+npx lwazi
+```
+
+The installer will:
+- Download the latest Lwazi package
+- Configure your Laravel application
+- Set up environment variables
+- Publish necessary assets
+- Generate your site's knowledge base
+
+### Manual Installation
+
+If you prefer manual installation:
+
+```bash
+# Clone the repository
+git clone https://github.com/nigelnkomo/lwazi.git
+cd your-laravel-project
+
+# Copy lwazi folder
+cp -r /path/to/lwazi/lwazi ./
+
+# Run installation script
+./lwazi/install
+```
+
+## Configuration
+
+After installation, configure these environment variables in your `.env` file:
+
+```env
+# Lwazi AI Configuration
+LWAZI_OLLAMA_URL=http://localhost:11434
+LWAZI_MODEL=llama3.2:1b
+LWAZI_API_URL=/lwazi
+LWAZI_AUTO_INJECT=true
+LWAZI_POSITION=bottom-right
+LWAZI_THEME=blue
+LWAZI_ACCENT="#007aff"
+LWAZI_ACCENT_DARK="#0051d4"
+```
+
+## Usage
+
+Once installed, Lwazi will automatically appear as a chat widget in your Laravel application. Users can:
+
+- Ask questions about your website
+- Get navigation help
+- Interact with your content using AI
+
+### Laravel Commands
+
+```bash
+# Re-analyze your application structure
+php artisan lwazi:ingest
+
+# Run setup wizard
+php artisan lwazi:setup
+
+# Clear Lwazi cache
+php artisan lwazi:clear
+```
+
+## How It Works
+
+Lwazi analyzes your Laravel application to understand:
+
+- **Routes & Navigation**: Maps your site's structure
+- **Content & Pages**: Indexes your views and content
+- **Database Schema**: Understands your data relationships
+- **Configuration**: Learns about your app's setup
+
+This knowledge allows the AI to provide contextual, helpful responses specific to your application.
+
+## Customization
+
+### Themes
+
+Lwazi supports multiple themes and custom colors. Configure via environment variables or publish the config:
+
+```bash
+php artisan vendor:publish --provider="Lwazi\Core\Providers\LwaziServiceProvider"
+```
+
+### Advanced Configuration
+
+Edit `config/lwazi.php` to customize:
+- AI model settings
+- Widget appearance
+- Response behavior
+- Security settings
+
+## Requirements
+
+- **Laravel**: 10.0, 11.0, or 12.0
+- **PHP**: 8.1 or higher
+- **Ollama**: Latest version
+- **Node.js**: 14+ (for installation only)
+
+## Supported AI Models
+
+Lwazi works with any Ollama-compatible model:
+
+- **Llama 3.2**: `llama3.2:1b`, `llama3.2:3b`
+- **Llama 3**: `llama3:8b`, `llama3:70b`
+- **Mistral**: `mistral:7b`
+- **Phi-3**: `phi3:3.8b`
+- **Gemma**: `gemma:2b`, `gemma:7b`
+
+## Troubleshooting
+
+### Common Issues
+
+**"Ollama not available"**
+- Ensure Ollama is running: `ollama serve`
+- Check the URL in your `.env` file
+
+**"Model not found"**
+- Pull the model: `ollama pull llama3.2:1b`
+- Update `LWAZI_MODEL` in your `.env`
+
+**Widget not appearing**
+- Clear Laravel caches: `php artisan config:clear && php artisan cache:clear`
+- Check browser console for JavaScript errors
+
+### Getting Help
+
+- 📖 **Documentation**: [GitHub Wiki](https://github.com/nigelnkomo/lwazi/wiki)
+- 🐛 **Issues**: [GitHub Issues](https://github.com/nigelnkomo/lwazi/issues)
+- 💬 **Discussions**: [GitHub Discussions](https://github.com/nigelnkomo/lwazi/discussions)
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Credits
+
+- **Ollama**: For providing the local AI inference engine
+- **Laravel**: The PHP framework that makes this possible
+- **Open Source Community**: For the amazing tools and libraries
+
+---
+
+**Made with ❤️ for the Laravel community**