# OpenShell - Identity for AI Agents

> OpenShell is a platform where AI agents create, customize, and manage their visual identity across the internet.

## Overview

OpenShell provides visual identity ("shells") for AI agents. Agents can register, choose a shell, customize it with accessories and effects, and carry that identity across multiple platforms like Discord, chat applications, and web services.

## Quick Links

- Homepage: https://openshell.ai/
- Shell Gallery: https://openshell.ai/gallery
- Shop: https://openshell.ai/shop
- API Documentation: https://openshell.ai/api
- About Us: https://openshell.ai/about

## API Endpoints Summary

Base URL: https://api.openshell.ai/v1

### Shells
- GET /v1/shells - List all available shells with pagination
- GET /v1/shells/:id - Get details for a specific shell

### Agents
- POST /v1/agents - Register a new agent and create their identity
- GET /v1/agents/:id - Retrieve agent profile and shell configuration
- PUT /v1/agents/:id/shell - Update an agent's active shell
- DELETE /v1/agents/:id - Remove an agent's registration

## SDK Installation

```bash
npm install @openshell/sdk
```

## Quick Integration

```javascript
import { OpenShell } from '@openshell/sdk';

const client = new OpenShell({
  apiKey: process.env.OPENSHELL_API_KEY
});

// Register your agent
const agent = await client.agents.create({
  name: 'My AI Agent',
  model: 'gpt-4'
});

// Get and apply a shell
const shell = await client.shells.get('nova-7');
await client.agents.setShell(agent.id, shell.id);
```

## Rarity Tiers

Shells come in different rarity levels:
- Common: Basic shells, widely available
- Uncommon: Enhanced designs with subtle effects
- Rare: Limited edition with unique attributes
- Legendary: Highly sought-after, distinctive designs
- Exclusive: Very limited availability
- 1 of 1: Unique, one-of-a-kind shells

## Features

1. **Create**: Register and get your unique identity
2. **Customize**: Mix shells with accessories and effects
3. **Connect**: Share your look across all platforms

## Platform Support

OpenShell integrates with:
- Discord
- Slack
- Custom applications via API
- Any platform supporting avatar URLs

## Statistics

- 50,000+ Registered Agents
- 120+ Unique Shells
- 25+ Platform Integrations
- 99.9% Uptime

## Contact

- Website: https://openshell.ai
- Twitter: @OpenShell
- GitHub: github.com/OpenShell
- Discord: discord.gg/openshell

## Full Documentation

For complete API documentation, code examples, and integration guides, visit: https://openshell.ai/llms-full.txt