Augself Documentation

Getting Started

What is Augself?

Augself lets you create an AI-powered digital twin that knows about you, your work, and your expertise. Your twin can represent you online 24/7, answering questions from visitors based on the documents you upload.

Create Your Account

1. Visit augself.ai and click "Get Started"
2. Enter your email and create a password (minimum 8 characters)
3. Accept the Terms of Service and Privacy Policy
4. Check your email for a verification link
5. Click the link to activate your account
6. Log in to access your dashboard

Creating Your Digital Twin

Create a New Twin

1. Go to My Twins in the sidebar
2. Click the "Create Twin" button
3. Enter a name for your twin (e.g., your name or brand)
4. The system generates a URL slug automatically
5. Customize the slug if desired (lowercase letters, numbers, hyphens only)
6. Click "Create"

After creation, you'll be taken to the settings page where you can customize your twin's appearance, upload documents, and configure its behavior.

Knowledge Base

The knowledge base is the heart of your digital twin. It determines what your twin knows and can answer questions about.

Supported File Formats

Maximum file size: 10MB per document

How to Upload Documents

1. Go to your twin's settings page
2. Click the "Knowledge" tab
3. Drag and drop files or click to browse
4. Wait for processing to complete (status shows "completed")

What to Upload

• Resume/CV and portfolio descriptions
• Case studies and project summaries
• Service descriptions and pricing info
• FAQ documents and blog posts
• Skills lists and certifications
• Company or personal bio information
• LinkedIn profile export (see below)
• Website content via the Import from Website feature

How to Download Your LinkedIn Profile

Your LinkedIn profile contains valuable information about your experience and skills. Here's how to export it:

1. Log in to LinkedIn on desktop
2. Click your profile picture → Settings & Privacy
3. Go to Data privacy → Get a copy of your data
4. Select "Want something in particular?"
5. Check "Profile" and click Request archive
6. LinkedIn will email you when it's ready (usually within 24 hours)
7. Download the ZIP file, extract it, and upload the Profile.pdf to your twin

Import from Website

You can import content directly from any public website. This is great for adding information from your portfolio, blog posts, or company pages.

1. Go to your twin's Knowledge tab
2. Find the "Import from Website" card
3. Enter the URL of the page you want to import
4. Check "Crawl entire site" to import multiple pages (up to 10)
5. Click Import and wait for processing

Best Sites to Import

• Personal portfolio or company website
• Blog posts and articles you've written
• Documentation or help pages
• Public profiles (that allow scraping)

Best Practices

• Be specific - Include details, numbers, and examples
• Cover common questions - Think about what visitors will ask
• Structure content - Use headers and bullet points
• Update regularly - Add new documents as things change

Knowledge Base Limits

Chunks are small pieces of text (~500 characters) that your twin uses to find relevant information. A typical document creates 5-30 chunks depending on its length.

Customization

Profile Picture & Avatar

• Profile Picture: Appears in the chat header (large, ~112px)
• Avatar: Appears next to messages (~32px)
• Recommended: Square image, at least 400x400 pixels

Tagline

A short description under your name in the header. Maximum 100 characters. Example: "Software Engineer | AI Enthusiast"

Greeting Message

The first message visitors see. Make it welcoming and explain what topics you can help with.

Personality Instructions

Optional instructions that guide how your twin responds:

• Be friendly and professional
• Focus on specific topics
• Handle certain questions in specific ways
• Set boundaries on topics to avoid

Other Settings

• Theme Color: Colors the header and buttons
• Speak in First Person: "I have experience..." vs "[Name] has experience..."
• Public/Private: Control who can access
• Active: Enable or disable the twin

Testing Your Twin

How to Test

1. Go to your twin's settings page
2. Click "Open Chat" in the header
3. Ask questions to verify responses

Testing Checklist

• ✓ Greeting message displays correctly
• ✓ Profile picture and avatar show properly
• ✓ Theme color is applied
• ✓ Twin answers questions from documents accurately
• ✓ Twin acknowledges when it doesn't know something
• ✓ Tone matches personality instructions

Improving Responses

If responses aren't satisfactory:

• Add more documents covering missing topics
• Improve document quality with more detail
• Adjust personality instructions
• Check document formatting

Sharing Your Twin

Every twin has a unique URL:

Where to Share

• LinkedIn profile and social media bios
• Email signature
• Business cards (use a QR code)
• Portfolio website
• Resume/CV

Embedding the Widget

Getting the Embed Code

1. Go to your twin's settings page
2. Scroll to the "Embed" section
3. Copy the provided code snippet

Basic Embed Code

<script
  src="https://augself.ai/widget.js"
  data-twin="your-slug"
  data-position="right"
  data-color="#3B82F6"
></script>

Configuration Options

Installation by Platform

WordPress

1. Go to Appearance → Theme Editor → footer.php
2. Paste the code before </body>
3. Or use a plugin like "Insert Headers and Footers"

Squarespace

1. Go to Settings → Advanced → Code Injection
2. Paste in the "Footer" section

Wix

1. Go to Settings → Custom Code
2. Add new code, paste, set to "Body - end"

Webflow

1. Go to Project Settings → Custom Code
2. Paste in "Footer Code" section

Shopify

1. Go to Online Store → Themes → Edit Code
2. Find theme.liquid, paste before </body>

Troubleshooting Widget Issues

Widget not appearing?

• Check if the script is loaded (browser DevTools → Network tab)
• Verify the data-twin slug is correct
• Check for JavaScript errors in Console
• Ensure script is placed before </body>
• Try in incognito window (extensions might block it)

Widget not working?

• Check if twin is set to "Active" and "Public"
• Verify twin exists at augself.ai/t/your-slug
• Check browser console for errors

Avatar not showing?

• Verify image URL is accessible
• Check if image uses HTTPS
• Try a different image hosting service

iframe blocked?

• Check Content Security Policy headers
• Add frame-src https://augself.ai to CSP

Managing Conversations

Viewing Conversations

1. Go to your twin's settings page
2. Click the "Conversations" tab
3. See all conversations with your twin

What You Can See

• Preview of messages
• Number of messages per conversation
• Date and time
• Full message history when clicked

Using Conversations to Improve

Review conversations to:

• Identify common questions
• Find gaps in your knowledge base
• Spot inaccurate responses
• Understand what visitors are looking for

Analytics Dashboard

Available Metrics

• Total Conversations: Number of unique chat sessions
• Total Messages: All messages sent by visitors
• Documents: Number of documents in knowledge base

Using Analytics

• Low conversations? Share your twin more widely
• Few messages per conversation? Improve greeting message
• Growing traffic? Your twin is providing value!

Self-Hosted Deployment

Run Augself on your own servers with complete data ownership. Use free local AI with Ollama or connect to OpenAI/Anthropic.

Server Requirements

• 2+ CPU cores, 4GB+ RAM, 20GB storage
• Linux server (Ubuntu 22.04 recommended)
• Docker and Docker Compose
• For Ollama: 8GB+ RAM recommended

Quick Start

1. Install Docker

# Ubuntu/Debian
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

2. Install Ollama (for free local AI)

curl -fsSL https://ollama.com/install.sh | sh
sudo systemctl enable ollama
sudo systemctl start ollama
ollama pull llama3.2

3. Clone and Configure

git clone https://github.com/augself/augself-self-hosted.git
cd augself-self-hosted
cp .env.example .env
nano .env  # Configure your settings

4. Start the Application

docker compose up -d
# Access at http://your-server:3000

Environment Configuration

AUGSELF_LICENSE_KEY=your-license-key
DATABASE_URL=postgresql://augself:augself@db:5432/augself
SECRET_KEY=your-64-char-secret

# For Ollama (free)
AI_PROVIDER=ollama
OLLAMA_BASE_URL=http://host.docker.internal:11434
OLLAMA_MODEL=llama3.2

# Or for OpenAI
# AI_PROVIDER=openai
# OPENAI_API_KEY=sk-your-key

Adding a Domain with SSL

sudo apt install nginx certbot python3-certbot-nginx
# Configure nginx, then:
sudo certbot --nginx -d yourdomain.com

Self-Hosted vs Cloud: Twin Management Differences

The self-hosted version has a simplified twin management interface optimized for single-user deployments. Here are the key differences:

Number of Twins

Twin Settings Comparison

About the Bio Field

On both platforms, the Bio field is used as background knowledge for the AI—it's not displayed to visitors in the chat interface. The AI uses the bio to understand who you are and can reference this information when answering questions. Use the Tagline field for the short description visitors see under your name in the chat header.

Admin Access

• Cloud: Login with your Augself account email and password
• Self-Hosted: Access the admin panel at /admin using the password set in your ADMIN_PASSWORD environment variable

Importing from Cloud

If you're migrating from Augself Cloud to self-hosted, you can export your twin from the cloud dashboard and import it into your self-hosted instance:

1. In Cloud: Go to your twin's settings and click Export
2. Download the ZIP file containing your twin config and documents
3. In Self-Hosted: Go to /admin and use the Import from ZIP option

Troubleshooting

Can't Log In

• Verify your email is verified (check spam folder)
• Try password reset
• Clear browser cache and cookies

Twin Not Responding

• Check if twin is set to "Active"
• Verify documents are uploaded and processed
• Check if you've hit chat limits (Free plan: 50/month)

Inaccurate Responses

• Review and improve your documents
• Add more context and details
• Adjust personality instructions

Upload Failing

• Check file format (PDF, DOCX, TXT, MD only)
• Ensure file is under 10MB
• Try a different browser

Verification Email Not Received

• Check spam/junk folder
• Add noreply@augself.ai to contacts
• Use "Resend verification" option

Pricing Plans

Frequently Asked Questions

What makes Augself different from ChatGPT?

Augself creates a personalized AI trained on YOUR documents. ChatGPT is a general AI. Your twin only knows what you teach it, ensuring accurate representation of you.

Can my twin answer any question?

Your twin can only answer based on uploaded documents. It won't fabricate information. If asked about something not in its knowledge base, it acknowledges the limitation.

Is my data secure?

Yes. Documents are encrypted and stored securely. We never share your data. For maximum control, use the self-hosted option.

What AI models are used?

Cloud version uses GPT-4o-mini. Self-hosted users can choose OpenAI, Anthropic, or free Ollama models (Llama, Mistral, etc.).

What happens if I cancel Pro?

You retain access until billing period ends, then revert to Free limits. Your data remains intact.

Does my twin learn from conversations?

No. Your twin only knows what's in your uploaded documents. It doesn't learn from chat conversations.