# Frequently Asked Questions

This section answers common questions about Genie, how it works, and how to use it effectively.

***

## General

### What is Genie?

Genie is an AI-powered cloud environment where your terminal, files, and AI assistant exist in one place. It allows you to run a full Linux system from your browser without setup or configuration.

***

### Do I need to install anything to use Genie?

No. Genie runs entirely in the browser. You do not need to install software, configure environments, or manage dependencies locally.

***

### Is Genie a virtual machine or a container?

Genie provides a dedicated cloud-based environment that behaves like a real Linux machine. Your system is persistent and not reset between sessions.

***

### Can I use Genie from any device?

Yes. You can access Genie from any device with a browser. Your environment remains the same regardless of where you log in.

***

## Server & Environment

### What operating system does Genie use?

Genie servers run on Ubuntu 22.04 LTS, providing a standard and widely supported Linux environment.

***

### Where are my files stored?

Your files are stored on a persistent disk attached to your server. The default workspace is:

```
/home/ubuntu/workspace
```

***

### Will my data be lost if I disconnect?

No. Your files, installed tools, and environment remain intact even if you disconnect or close your browser.

***

### Can I install my own tools and dependencies?

Yes. You have full control over your environment and can install tools using standard package managers like apt, npm, and pip.

***

## Terminal & File System

### Is the terminal fully functional?

Yes. Genie provides a real terminal connected to your server. You can run commands, manage files, and execute processes just like a local Linux system.

***

### Can I run long processes or servers?

Yes. You can run applications and long-running processes directly on your server. They continue to run as part of your environment.

***

### Are files synchronized between terminal and file manager?

Yes. Both interfaces operate on the same filesystem. Changes made in one are instantly reflected in the other.

***

## AI & Chat Interface

### What can the AI assistant do?

The AI can help you write code, debug errors, suggest commands, and assist with workflows. It understands your environment and provides context-aware responses.

***

### Can the AI execute commands?

The AI can guide and assist with commands. Depending on permissions and usage, it can help translate instructions into actions within your environment.

***

### Does the AI have access to my files?

The AI can understand and reference your workspace context, which allows it to provide relevant assistance.

***

## Messaging Integration

### Can I use Genie without opening the browser?

Yes. Genie integrates with platforms like Telegram and Discord, allowing you to interact with your AI and environment remotely.

***

### What can I do from Telegram or Discord?

You can ask questions, check logs, run commands through AI assistance, and receive updates about your environment.

***

### Is the experience the same across platforms?

Yes. All interactions use the same server and context, so your workflow remains consistent across web and messaging platforms.

***

## Plans & Credits

### How do Genie plans work?

Plans determine your server resources, performance, and AI usage limits. All plans include a complete environment, with differences based on capacity and usage.

***

### What are AI credits?

Credits are used when interacting with the AI assistant. Each plan includes a daily allocation of credits.

***

### What happens if I run out of credits?

You may need to wait for credits to refresh or upgrade your plan to increase your usage limits.

***

### Can I upgrade my plan anytime?

Yes. You can upgrade your plan at any time without losing your environment, files, or progress.

***

## Usage & Workflow

### Do I need to know Linux to use Genie?

Basic knowledge helps, but it is not required. The AI assistant can guide you through commands and workflows.

***

### Can I use Genie for real projects?

Yes. Genie is designed for both learning and production workflows. You can build, run, and manage real applications.

***

### Can I access Genie anytime?

Yes. Your environment is always available and can be accessed whenever you log in.

***

## Troubleshooting

### What should I do if something is not working?

Start by checking your terminal output and verifying your commands. You can also ask the AI assistant for help with debugging.

***

### What if my interface stops responding?

Try refreshing the browser or reconnecting your session. Your server state will remain unchanged.

***

### How do I check my current directory?

You can run:

```bash
pwd
```

***

### How do I verify files in my workspace?

```bash
ls
```

***

## Final Note

If your question is not listed here, you can always use the AI assistant inside Genie to get help based on your current environment.
