vibe-sort 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57341544b7a583956dde5f307ad0705fd01f70994ea5fc634557ddc2ec045b55
-  data.tar.gz: 823b1d1d124ae00d2abaae240d74917df07452b6161619ec6e398362f266c8ea
+  metadata.gz: 2f7d0e027ef929afd808fecba7f64a697a87ff6be489bce20bf9a8da73334847
+  data.tar.gz: b59cb7de762f093a8a5c0ac702841b4bad42d68599a346135a69867af54b6407
 SHA512:
-  metadata.gz: b0158f11c6899b503b183b50933d14485f19c4bcee3dbf75fb8e8ff3149eb279e8ec5af52a8bd6fea1cd15ca35255dde7a5884a1e0ec133b51d6c3de9f4fad36
-  data.tar.gz: d59a672c3b38922cf213ad0011bea552b02b0b66d79e600f42df37dd213e6683ef512f0d7413a98930b8f588e54942868dd3f421dec24e9d86c9f95a268ce9a2
+  metadata.gz: 53ac2db8b8b227fd151542ed86a350aab7bf6e3a740347cef034348f175465f3e17b7f32b6ca868da4c300bc0ad7b681b5fcdc84375e58838115e0f0d34ec0ac
+  data.tar.gz: 604e37c539b045cf9ecc3ff12a88fa467514506fb9149a2e02d85278f5a2dbd468ecf0cacf9259922dca87d21cdff4fd7f247cfad8dcf5752e5289ae82a2662c

data/CHANGELOG.md

@@ -7,6 +7,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-07-11
+
+### Changed
+
+- Gemspec summary and description now list all five supported providers (OpenAI, Anthropic Claude, Google Gemini, Groq, SpaceXAI Grok)
+- Added `documentation_uri` and `bug_tracker_uri` gem metadata links
+
+## [0.3.0] - 2026-07-10
+
+### Added
+
+- **Multi-Provider Support**: Sort via OpenAI, Anthropic Claude, Google Gemini, Groq, or SpaceXAI (xAI) Grok
+- `provider:` option on `VibeSort::Client.new` (`:openai` default, `:anthropic`, `:gemini`, `:groq`, `:spacexai`)
+- `model:` option to override each provider's default model
+- `VibeSort::Providers::Base` adapter layer with per-provider subclasses
+- Anthropic adapter uses the Messages API with structured outputs (JSON schema), guaranteeing the response shape
+- Gemini adapter uses `generateContent` with JSON response mode
+- Groq and SpaceXAI adapters reuse the OpenAI-compatible Chat Completions wire format
+- Provider-specific test suites backed by WebMock
+
+### Changed
+
+- `VibeSort::Sorter` is now a thin dispatcher to the configured provider adapter
+- OpenAI default model updated from the deprecated `gpt-3.5-turbo-1106` to `gpt-4o-mini`
+- Error messages are prefixed with the provider name (e.g. "Anthropic API error: ...")
+- `temperature` is not sent to Anthropic (current Claude models reject the parameter)
+
+### Notes
+
+- Fully backward compatible: `VibeSort::Client.new(api_key: ...)` still defaults to OpenAI
+- Still zero runtime dependencies beyond Faraday, all providers are called over plain HTTPS
+
 ## [0.2.0] - 2025-10-16
 
 ### Added

data/README.md

@@ -1,34 +1,35 @@
-# 🌀 VibeSort
+# VibeSort
 
-> **AI-powered array sorting using OpenAI's GPT models**
+> **AI-powered array sorting using OpenAI, Anthropic Claude, Google Gemini, Groq, or SpaceXAI Grok**
 
-VibeSort is a proof-of-concept Ruby gem that demonstrates sorting number arrays by leveraging the OpenAI Chat Completions API. Instead of using traditional sorting algorithms, it asks GPT to do the work!
+VibeSort is a proof-of-concept Ruby gem that demonstrates sorting arrays by leveraging LLM APIs. Instead of using traditional sorting algorithms, it asks an AI model to do the work. Supports the OpenAI Chat Completions API, the Anthropic Messages API, the Google Gemini API, and the OpenAI-compatible Groq and SpaceXAI (xAI) APIs, with zero dependencies beyond Faraday.
 
 [![Gem Version](https://badge.fury.io/rb/vibe-sort.svg)](https://badge.fury.io/rb/vibe-sort)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## ⚠️ Disclaimer
+## Disclaimer
 
-This is a **proof-of-concept** and educational project. It is not intended for production use. Traditional sorting algorithms are far more efficient, reliable, and cost-effective. Use this gem to explore AI capabilities, not to sort arrays in real applications!
+This is a **proof-of-concept** and educational project. It is not intended for production use. Traditional sorting algorithms are far more efficient, reliable, and cost-effective. Use this gem to explore AI capabilities, not to sort arrays in real applications.
 
-## ✨ Features
+## Features
 
-- 🤖 **AI-Powered Sorting**: Uses OpenAI's GPT models to sort arrays
-- 🎯 **Simple Interface**: Clean, intuitive API with a single `sort` method
-- 🔧 **Configurable**: Supports custom temperature settings for model behavior
-- 🛡️ **Error Handling**: Comprehensive error handling with clear error messages
-- 📊 **Structured Output**: Uses JSON mode for reliable, parsable responses
-- 🔍 **Type Validation**: Validates input and output to ensure data integrity
-- 📝 **Mixed-Type Support**: Sorts arrays containing integers, floats, and strings
+- **AI-Powered Sorting**: Uses OpenAI, Anthropic Claude, Google Gemini, Groq, or SpaceXAI Grok models to sort arrays
+- **Multi-Provider**: Switch providers with a single `provider:` option, no extra dependencies
+- **Simple Interface**: Clean, intuitive API with a single `sort` method
+- **Configurable**: Supports custom model and temperature settings
+- **Error Handling**: Comprehensive error handling with clear error messages
+- **Structured Output**: Uses JSON mode for reliable, parsable responses
+- **Type Validation**: Validates input and output to ensure data integrity
+- **Mixed-Type Support**: Sorts arrays containing integers, floats, and strings
 
-## ✅ Requirements
+## Requirements
 
 - Ruby **3.0** or newer (MRI)
 - Bundler **2.0+**
-- An OpenAI API key with access to the Chat Completions API
+- An API key for at least one supported provider (OpenAI, Anthropic, Google Gemini, Groq, or SpaceXAI)
 - Internet connectivity (each sort performs a remote API call)
 
-## 📦 Installation
+## Installation
 
 Add this line to your application's Gemfile:
 
@@ -48,7 +49,7 @@ Or install it yourself as:
 gem install vibe-sort
 ```
 
-## ⚡ Quick Start
+## Quick Start
 
 ```bash
 export OPENAI_API_KEY="your-openai-api-key"
@@ -67,7 +68,7 @@ client.sort([34, 1, 'Apple', 8.5])
 # => { success: true, sorted_array: [1, 8.5, 34, "Apple"] }
 ```
 
-## 🚀 Usage
+## Usage
 
 ### Basic Usage
 
@@ -82,12 +83,12 @@ numbers = [34, 1, 99, 15, 8]
 result = client.sort(numbers)
 
 if result[:success]
-  puts "✅ Vibe Sort successful!"
+  puts "Vibe Sort successful!"
   puts "Original: #{numbers}"
   puts "Sorted: #{result[:sorted_array]}"
   # Output: [1, 8, 15, 34, 99]
 else
-  puts "❌ Vibe Sort failed: #{result[:error]}"
+  puts "Vibe Sort failed: #{result[:error]}"
 end
 ```
 
@@ -118,6 +119,46 @@ if result[:success]
 end
 ```
 
+### Choosing a Provider
+
+VibeSort defaults to OpenAI, but any supported provider can be selected with the `provider:` option:
+
+```ruby
+# OpenAI (default)
+client = VibeSort::Client.new(api_key: ENV['OPENAI_API_KEY'])
+
+# Anthropic Claude
+client = VibeSort::Client.new(provider: :anthropic, api_key: ENV['ANTHROPIC_API_KEY'])
+
+# Google Gemini
+client = VibeSort::Client.new(provider: :gemini, api_key: ENV['GEMINI_API_KEY'])
+
+# Groq (fast open-model inference)
+client = VibeSort::Client.new(provider: :groq, api_key: ENV['GROQ_API_KEY'])
+
+# SpaceXAI (formerly xAI) Grok
+client = VibeSort::Client.new(provider: :spacexai, api_key: ENV['XAI_API_KEY'])
+```
+
+| Provider | API | Default model | Override with `model:` |
+|---|---|---|---|
+| `:openai` | Chat Completions | `gpt-4o-mini` | any chat model |
+| `:anthropic` | Messages | `claude-opus-4-8` | e.g. `claude-haiku-4-5` for cheaper sorts |
+| `:gemini` | generateContent | `gemini-2.5-flash` | e.g. `gemini-2.5-pro` |
+| `:groq` | Chat Completions (OpenAI-compatible) | `llama-3.3-70b-versatile` | any Groq-hosted model |
+| `:spacexai` | Chat Completions (OpenAI-compatible) | `grok-4` | e.g. `grok-4.5` |
+
+> **Groq is not Grok**: Groq is the independent fast-inference company (`api.groq.com`); Grok is SpaceXAI's model (`api.x.ai`). They are unrelated, and VibeSort supports both.
+
+```ruby
+# Pick a specific model
+client = VibeSort::Client.new(
+  provider: :anthropic,
+  api_key: ENV['ANTHROPIC_API_KEY'],
+  model: 'claude-haiku-4-5'
+)
+```
+
 ### Advanced Configuration
 
 You can customize the model's behavior using the `temperature` parameter:
@@ -129,13 +170,15 @@ client = VibeSort::Client.new(
   temperature: 0.0
 )
 
-# Higher temperature = more creative/random (not recommended for sorting!)
+# Higher temperature = more creative/random (not recommended for sorting)
 creative_client = VibeSort::Client.new(
   api_key: ENV['OPENAI_API_KEY'],
   temperature: 0.5
 )
 ```
 
+> **Note**: current Anthropic Claude models no longer accept a `temperature` parameter, so it is ignored when `provider: :anthropic` is used.
+
 ### Error Handling
 
 VibeSort provides detailed error information:
@@ -176,24 +219,26 @@ The `sort` method always returns a hash with the following structure:
 - **Strings only**: Sorted in ascending alphabetical order (case-sensitive)
 - **Mixed types**: Numbers come before strings; each group sorted within itself
 
-## 🏗️ Architecture
+## Architecture
 
 VibeSort follows a clean, modular architecture:
 
 - **`VibeSort::Client`**: Public interface for users
-- **`VibeSort::Configuration`**: Manages API key and settings
-- **`VibeSort::Sorter`**: Handles OpenAI API communication via Faraday
+- **`VibeSort::Configuration`**: Manages provider, API key, model, and settings
+- **`VibeSort::Sorter`**: Dispatches to the configured provider adapter
+- **`VibeSort::Providers::Base`**: Shared prompt, HTTP plumbing (Faraday), and response validation
+- **`VibeSort::Providers::{OpenAI, Anthropic, Gemini, Groq, SpaceXAI}`**: Provider-specific request/response mapping
 - **`VibeSort::ApiError`**: Custom exception for API-related errors
 
 See the [Architecture Documentation](docs/architecture.md) for more details.
 
-## 📚 Documentation
+## Documentation
 
 - [Architecture Overview](docs/architecture.md)
 - [API Reference](docs/api_reference.md)
 - [Development Guide](docs/development.md)
 
-## 🧪 Development
+## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
@@ -221,38 +266,42 @@ bundle exec rspec --format documentation
 bundle exec rspec spec/vibe/sort_spec.rb
 ```
 
-## 🤔 Why Does This Exist?
+## Why Does This Exist?
 
 This gem was created as an educational exercise to:
 
 1. Explore the capabilities and limitations of LLMs for computational tasks
-2. Demonstrate how to integrate OpenAI's API into Ruby applications
+2. Demonstrate how to integrate LLM APIs into Ruby applications
 3. Provide a template for building Ruby gems with external API dependencies
 4. Spark conversations about appropriate use cases for AI
 
-**Please note**: This is intentionally inefficient and expensive compared to traditional sorting algorithms. It's a conversation starter, not a production solution!
+**Please note**: This is intentionally inefficient and expensive compared to traditional sorting algorithms. It's a conversation starter, not a production solution.
 
-## ⚡ Performance Considerations
+## Performance Considerations
 
 - **Latency**: Each sort requires an API call (typically 1-3 seconds)
-- **Cost**: OpenAI API usage is metered and costs money
+- **Cost**: LLM API usage is metered and costs money
 - **Reliability**: Depends on API availability and internet connection
 - **Accuracy**: Generally accurate, but not guaranteed (unlike algorithmic sorting)
 - **Scale**: Not suitable for large arrays or high-frequency sorting
 
 Traditional sorting (e.g., Ruby's `Array#sort`) is:
 
-- ⚡ **10,000x faster** (microseconds vs seconds)
-- 💰 **Free** (no API costs)
-- 🎯 **100% reliable** (deterministic algorithm)
-- 📈 **Scalable** (handles millions of elements)
+- **10,000x faster** (microseconds vs seconds)
+- **Free** (no API costs)
+- **100% reliable** (deterministic algorithm)
+- **Scalable** (handles millions of elements)
 
-## 🔑 Environment Variables
+## Environment Variables
 
-Set your OpenAI API key as an environment variable:
+Set the API key for your chosen provider as an environment variable:
 
 ```bash
-export OPENAI_API_KEY='your-api-key-here'
+export OPENAI_API_KEY='your-api-key-here'     # provider: :openai (default)
+export ANTHROPIC_API_KEY='your-api-key-here'  # provider: :anthropic
+export GEMINI_API_KEY='your-api-key-here'     # provider: :gemini
+export GROQ_API_KEY='your-api-key-here'       # provider: :groq
+export XAI_API_KEY='your-api-key-here'        # provider: :spacexai
 ```
 
 Or use a `.env` file with the `dotenv` gem:
@@ -266,16 +315,16 @@ require 'dotenv/load'
 client = VibeSort::Client.new(api_key: ENV['OPENAI_API_KEY'])
 ```
 
-## 📄 License
+## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
-## 🙏 Acknowledgments
+## Acknowledgments
 
 - Built with [Faraday](https://lostisland.github.io/faraday/) for HTTP requests
-- Powered by [OpenAI](https://openai.com/) GPT models
+- Powered by [OpenAI](https://openai.com/), [Anthropic](https://www.anthropic.com/), [Google Gemini](https://ai.google.dev/), [Groq](https://groq.com/), and [SpaceXAI](https://x.ai/) models
 - Inspired by the absurdity and creativity of the AI era
 
 ---
 
-**Remember**: With great AI power comes great responsibility (and API bills). Sort wisely! 🧙‍♂️
+**Remember**: With great AI power comes great responsibility (and API bills). Sort wisely.

data/docs/IMPLEMENTATION_PLAN.md

@@ -4,7 +4,7 @@
 
 This document outlines the complete implementation plan for the **VibeSort** Ruby gem - a proof-of-concept library that sorts number arrays using the OpenAI Chat Completions API.
 
-**Status:** ✅ Complete (All tasks finished)
+**Status:**  Complete (All tasks finished)
 
 **Version:** 0.1.0
 
@@ -16,23 +16,23 @@ This document outlines the complete implementation plan for the **VibeSort** Rub
 
 ### Primary Goals
 
-1. ✅ Create a functional Ruby gem that sorts arrays via OpenAI API
-2. ✅ Demonstrate AI integration in Ruby applications
-3. ✅ Provide clean, well-documented code as a learning resource
-4. ✅ Follow Ruby gem best practices and conventions
+1.  Create a functional Ruby gem that sorts arrays via OpenAI API
+2.  Demonstrate AI integration in Ruby applications
+3.  Provide clean, well-documented code as a learning resource
+4.  Follow Ruby gem best practices and conventions
 
 ### Non-Goals
 
-- ❌ Production-ready sorting solution (this is a proof-of-concept)
-- ❌ Performance optimization (intentionally uses AI for education)
-- ❌ Support for non-numeric data types
-- ❌ Local sorting fallback (requires API)
+-  Production-ready sorting solution (this is a proof-of-concept)
+-  Performance optimization (intentionally uses AI for education)
+-  Support for non-numeric data types
+-  Local sorting fallback (requires API)
 
 ---
 
 ## Implementation Checklist
 
-### Phase 1: Project Setup ✅
+### Phase 1: Project Setup 
 
 - [x] Initialize gem structure with Bundler
 - [x] Configure gemspec with metadata and dependencies
@@ -40,7 +40,7 @@ This document outlines the complete implementation plan for the **VibeSort** Rub
 - [x] Configure RSpec for testing
 - [x] Add development dependencies (pry for debugging)
 
-### Phase 2: Core Implementation ✅
+### Phase 2: Core Implementation 
 
 - [x] **VibeSort::Configuration** - API key and settings management
   - API key validation
@@ -70,7 +70,7 @@ This document outlines the complete implementation plan for the **VibeSort** Rub
   - Load all components
   - Namespace definition
 
-### Phase 3: Documentation ✅
+### Phase 3: Documentation 
 
 - [x] **README.md** - User-facing documentation
   - Installation instructions
@@ -174,13 +174,13 @@ This document outlines the complete implementation plan for the **VibeSort** Rub
 ```
 vibe-sort/
 ├── lib/
-│   ├── vibe_sort.rb              ✅ Main entry point
+│   ├── vibe_sort.rb               Main entry point
 │   └── vibe_sort/
-│       ├── client.rb             ✅ Public API
-│       ├── configuration.rb      ✅ Config object
-│       ├── error.rb              ✅ Custom exceptions
-│       ├── sorter.rb             ✅ API communication
-│       └── version.rb            ✅ Version constant
+│       ├── client.rb              Public API
+│       ├── configuration.rb       Config object
+│       ├── error.rb               Custom exceptions
+│       ├── sorter.rb              API communication
+│       └── version.rb             Version constant
 ├── spec/
 │   ├── spec_helper.rb            ⏳ To be implemented
 │   └── vibe_sort/
@@ -189,19 +189,19 @@ vibe-sort/
 │       ├── sorter_spec.rb        ⏳ To be implemented
 │       └── integration_spec.rb   ⏳ To be implemented
 ├── docs/
-│   ├── README.md                 ✅ Documentation index
-│   ├── architecture.md           ✅ Architecture guide
-│   ├── api_reference.md          ✅ API documentation
-│   └── development.md            ✅ Development guide
+│   ├── README.md                  Documentation index
+│   ├── architecture.md            Architecture guide
+│   ├── api_reference.md           API documentation
+│   └── development.md             Development guide
 ├── bin/
-│   ├── console                   ✅ Interactive console
-│   └── setup                     ✅ Setup script
-├── Gemfile                       ✅ Dependencies
-├── Rakefile                      ✅ Rake tasks
-├── vibe-sort.gemspec             ✅ Gem specification
-├── README.md                     ✅ User documentation
-├── CHANGELOG.md                  ✅ Version history
-└── LICENSE.txt                   ✅ MIT License
+│   ├── console                    Interactive console
+│   └── setup                      Setup script
+├── Gemfile                        Dependencies
+├── Rakefile                       Rake tasks
+├── vibe-sort.gemspec              Gem specification
+├── README.md                      User documentation
+├── CHANGELOG.md                   Version history
+└── LICENSE.txt                    MIT License
 ```
 
 ---
@@ -299,26 +299,26 @@ client = VibeSort::Client.new(
 
 ### API Key Management
 
-✅ **Implemented:**
+ **Implemented:**
 - Environment variable support
 - Configuration validation
 - No hardcoded keys in examples
 
-⚠️ **User Responsibility:**
+ **User Responsibility:**
 - Store keys securely
 - Use .env files (not committed)
 - Rotate keys regularly
 
 ### Input Validation
 
-✅ **Implemented:**
+ **Implemented:**
 - Type checking (must be Array)
 - Element validation (must be Numeric)
 - Empty array rejection
 
 ### Output Validation
 
-✅ **Implemented:**
+ **Implemented:**
 - Response structure validation
 - Type checking on sorted array
 - Numeric value verification
@@ -366,7 +366,7 @@ client = VibeSort::Client.new(
 
 ## Release Plan
 
-### Version 0.1.0 (Initial Release) ✅
+### Version 0.1.0 (Initial Release) 
 
 **Release Date:** October 16, 2025
 
@@ -408,7 +408,7 @@ client = VibeSort::Client.new(
 
 ## Success Criteria
 
-### Functional Requirements ✅
+### Functional Requirements 
 
 - [x] Successfully sort arrays of numbers
 - [x] Handle invalid inputs gracefully
@@ -416,7 +416,7 @@ client = VibeSort::Client.new(
 - [x] Integrate with OpenAI API
 - [x] Support configuration options
 
-### Non-Functional Requirements ✅
+### Non-Functional Requirements 
 
 - [x] Clear, comprehensive documentation
 - [x] Clean, readable code
@@ -424,7 +424,7 @@ client = VibeSort::Client.new(
 - [x] Ruby gem best practices
 - [x] MIT License
 
-### Documentation Requirements ✅
+### Documentation Requirements 
 
 - [x] Installation instructions
 - [x] Usage examples
@@ -441,39 +441,39 @@ client = VibeSort::Client.new(
 
 | Risk | Impact | Mitigation | Status |
 |------|--------|------------|--------|
-| API rate limits | High | Document limits, add retry logic | ⚠️ Documented |
-| API downtime | High | Graceful error handling | ✅ Implemented |
-| API changes | Medium | Version pinning, monitoring | ⚠️ Documented |
-| Cost overruns | Medium | Cost warnings in docs | ✅ Documented |
-| Network issues | Medium | Timeout handling | ✅ Implemented |
+| API rate limits | High | Document limits, add retry logic |  Documented |
+| API downtime | High | Graceful error handling |  Implemented |
+| API changes | Medium | Version pinning, monitoring |  Documented |
+| Cost overruns | Medium | Cost warnings in docs |  Documented |
+| Network issues | Medium | Timeout handling |  Implemented |
 
 ### Business Risks
 
 | Risk | Impact | Mitigation | Status |
 |------|--------|------------|--------|
-| Misuse in production | Low | Clear disclaimers | ✅ Documented |
-| API cost complaints | Low | Cost transparency | ✅ Documented |
-| Performance expectations | Low | Performance warnings | ✅ Documented |
+| Misuse in production | Low | Clear disclaimers |  Documented |
+| API cost complaints | Low | Cost transparency |  Documented |
+| Performance expectations | Low | Performance warnings |  Documented |
 
 ---
 
 ## Lessons Learned
 
-### What Went Well ✅
+### What Went Well 
 
 1. Clean architecture with separation of concerns
 2. Comprehensive documentation from the start
 3. Consistent error handling strategy
 4. Simple, intuitive API design
 
-### What Could Be Improved 🔄
+### What Could Be Improved 
 
 1. Test suite should have been implemented first (TDD)
 2. CI/CD pipeline not yet set up
 3. No integration with GitHub Actions
 4. Missing code coverage reporting
 
-### Best Practices Applied 🌟
+### Best Practices Applied 
 
 1. **Separation of Concerns:** Client, Configuration, Sorter, Error
 2. **Dependency Injection:** Configuration passed to Sorter
@@ -513,7 +513,7 @@ client = VibeSort::Client.new(
 
 The VibeSort gem v0.1.0 is complete and ready for release. All core functionality has been implemented, tested manually, and thoroughly documented. The gem serves as both a proof-of-concept for AI integration and an educational resource for Ruby developers.
 
-**Status:** ✅ Ready for Release
+**Status:**  Ready for Release
 
 **Next Milestone:** v0.2.0 with comprehensive test suite
 

data/docs/README.md

@@ -2,7 +2,7 @@
 
 Welcome to the VibeSort documentation! This directory contains comprehensive guides for using, understanding, and contributing to the VibeSort gem.
 
-## 📚 Documentation Overview
+## Documentation Overview
 
 ### [Architecture Overview](architecture.md)
 
@@ -52,7 +52,7 @@ Welcome to the VibeSort documentation! This directory contains comprehensive gui
 
 ---
 
-## 🚀 Quick Links
+## Quick Links
 
 ### For Users
 
@@ -76,7 +76,7 @@ Welcome to the VibeSort documentation! This directory contains comprehensive gui
 
 ---
 
-## 📖 Reading Guide
+## Reading Guide
 
 ### I want to use VibeSort in my project
 
@@ -107,25 +107,25 @@ Welcome to the VibeSort documentation! This directory contains comprehensive gui
 
 ---
 
-## 🏗️ Architecture at a Glance
+## Architecture at a Glance
 
 ```
 User Application
-      ↓
+      
 VibeSort::Client (validates input, handles errors)
-      ↓
+      
 VibeSort::Configuration (stores API key, settings)
-      ↓
+      
 VibeSort::Sorter (communicates with OpenAI)
-      ↓
+      
 OpenAI API (GPT model processes request)
-      ↓
+      
 Sorted Array (returned to user)
 ```
 
 ---
 
-## 📝 Example Usage
+## Example Usage
 
 ```ruby
 require 'vibe_sort'
@@ -148,7 +148,7 @@ For more examples, see the [README](../README.md) or [API Reference](api_referen
 
 ---
 
-## 🔧 Key Concepts
+## Key Concepts
 
 ### Configuration
 
@@ -175,7 +175,7 @@ VibeSort never raises exceptions to user code. All errors are caught and returne
 
 ---
 
-## 🤝 Contributing
+## Contributing
 
 We welcome contributions! Please see:
 
@@ -185,22 +185,22 @@ We welcome contributions! Please see:
 
 ---
 
-## 📞 Support
+## Support
 
-- 🐛 [Report a Bug](https://github.com/chayut/vibe-sort/issues/new?labels=bug)
-- 💡 [Request a Feature](https://github.com/chayut/vibe-sort/issues/new?labels=enhancement)
-- 📖 [Read the Docs](README.md)
-- 💬 [Discussions](https://github.com/chayut/vibe-sort/discussions)
+-  [Report a Bug](https://github.com/chayut/vibe-sort/issues/new?labels=bug)
+-  [Request a Feature](https://github.com/chayut/vibe-sort/issues/new?labels=enhancement)
+-  [Read the Docs](README.md)
+-  [Discussions](https://github.com/chayut/vibe-sort/discussions)
 
 ---
 
-## 📜 License
+## License
 
 VibeSort is released under the [MIT License](../LICENSE.txt).
 
 ---
 
-## 🙏 Acknowledgments
+## Acknowledgments
 
 - Built with [Faraday](https://lostisland.github.io/faraday/)
 - Powered by [OpenAI](https://openai.com/)
@@ -208,4 +208,4 @@ VibeSort is released under the [MIT License](../LICENSE.txt).
 
 ---
 
-**Happy Sorting! 🌀**
+**Happy Sorting! **