Back to Docs

Frequently Asked Questions

Common questions about Awareness, your AI collaborator, and how it works.

How is this different from ChatGPT or other AI chatbots?

Chatbots answer questions. Your Awareness builds things.

ChatGPT can write code snippets. Your Awareness can create databases, build workflows, generate dashboards, and connect to your actual systems. It has the same tools you have.

Plus, it remembers everything about you and your projects. Each Awareness Space has its own context and memory specific to that project.

Do I need to know how to code?

No. You describe what you need in plain English, and your Awareness builds it. Want a dashboard showing revenue by region? Just ask. Need a workflow that sends alerts when inventory is low? Describe it. Your Awareness handles the technical implementation.

Where is my data stored?

Awareness is self-hosted. All your data stays on your infrastructure—your servers, your cloud account, your control.

We never see your data. Your databases, files, and Awareness Spaces run entirely on your infrastructure. See our Security page for details.

What happens if I delete an Awareness Space?

Everything in that Space is deleted: databases, files, workflows, dashboards, and your Awareness's memory for that Space. Other Spaces are unaffected. Space deletion is permanent and cannot be undone.

Can multiple people work in the same Space?

Yes. You can invite teammates with different permission levels:

  • Owner: Full control, can delete Space
  • Admin: Manage resources, can't delete Space
  • Member: Read/write access, can't invite others
  • Viewer: Read-only access

Your Awareness works with everyone on the team and remembers conversations with all members.

How much does it cost?

Awareness is self-hosted and open source. There are no monthly subscription fees.

You'll need:

  • Server/cloud infrastructure to run it (AWS, GCP, or your own servers)
  • LLM API costs (OpenAI, Anthropic, or local models—your choice)

Most users spend $20-100/mo on infrastructure depending on scale, compared to $500+/mo for the SaaS tools Awareness replaces.

What are the limitations? What CAN'T it do?

Your Awareness is powerful but not magic:

  • Can't access systems you haven't connected - You need to give it OAuth access or database credentials
  • Requires approval for destructive actions - Deleting databases, removing files, etc. need your confirmation
  • Works within tool limits - Database query timeouts, file size limits, workflow execution limits exist
  • Not a replacement for human judgment - It builds what you ask for; you decide what to build

Can I export my data and leave?

Yes. Since you're self-hosting, you own everything. All data is in standard formats (PostgreSQL, Neo4j, S3, etc.). You can export, migrate, or shut down anytime with no lock-in.

How does Your Awareness learn? Does it improve over time?

Your Awareness learns from every interaction within a Space:

  • Remembers your preferences and working style
  • Learns from corrections you make
  • Adapts to your communication patterns
  • Understands your project context better over time

Each Space's Awareness learns independently—your startup Space doesn't share context with your side project Space.

What databases and integrations are supported?

Databases: PostgreSQL, MongoDB, Neo4j

Storage: Local filesystem, AWS S3, MinIO, Git repositories

OAuth Integrations (40+): Google (Gmail, Drive, Calendar), Slack, GitHub, Stripe, Shopify, Salesforce, Microsoft, and more

See the Connections page for the full list.

How is this different from Retool or other internal tool builders?

Retool is a UI builder—you drag and drop components and wire them up manually.

Awareness is a collaborative platform. You describe what you need, and your Awareness builds it. Instead of spending hours configuring a dashboard, you say "show me revenue by region" and it's done.

Plus, Awareness includes databases, workflows, file storage, and integrations—not just UI building.

What if Your Awareness makes a mistake?

You can:

  • Correct it: "Actually, use MongoDB instead of PostgreSQL"
  • Undo it: Awareness Spaces support rollback for critical operations
  • Review before execution: Destructive actions require approval
  • Edit manually: Everything it builds can be modified via UI

Your Awareness learns from corrections and won't repeat the same mistake.

Can I use my own LLM models?

Yes. Awareness supports OpenAI, Anthropic, Google, DeepSeek, and local models via Ollama. You control which model your Awareness uses and can switch anytime.

Is there a demo or trial?

Since Awareness is self-hosted, there's no cloud trial. However:

  • Full source code is available for review
  • Docker Compose setup gets you running locally in minutes
  • Example Awareness Spaces included to explore

See the Getting Started guide to set up your first Space.

What's the roadmap? What's coming next?

Upcoming features:

  • Multi-agent collaboration (multiple Awareness instances working together)
  • Advanced RAG with GraphRAG for better knowledge retrieval
  • Voice interface for hands-free collaboration
  • Mobile app for on-the-go access
  • More integrations and database support

Follow development on GitHub.

Still have questions?

Check out our community forum or read the detailed documentation.