> For the complete documentation index, see [llms.txt](https://docs.nexos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexos.ai/workspace/projects.md).

# Projects

Use Projects to organize conversations, ground answers in your data, and work on specific topics. Each Project acts as a container with its own files, chat history, and model set.Add the name that will be used for the project

{% stepper %}
{% step %}

### Create a project

Click "Create project" button below "Project name" input or create icon on the top right side of the menu.
{% endstep %}

{% step %}

### Add files

Attach files to your project to provide source material that will be indexed and used in your chats. \
nexos uses Retrieval-Augmented Generation (RAG) to pull relevant context from your files when responding.

* **Supported file types**: csv, xls, xlsx, json, docx, doc, pptx, ppt, txt, xml, tiff,  pdf
* **File size limits**: Up to 30MB per file
* **Vectorization**: Files are chunked, embedded, and stored securely in your project’s context index

{% hint style="info" %}
Only use trusted models when working with sensitive or proprietary content. While files stay scoped to your project, responses depend on the model’s ability to handle data securely.
{% endhint %}
{% endstep %}

{% step %}

### Model selection & chat

You have full control over which model powers your conversation.

* Select from available LLMs (OpenAI, Anthropic, Mistral, etc.)
* Use the **“Model Settings”** dropdown inside each chat
* Switch models anytime to compare outputs or adjust cost-performance tradeoffs

#### Begin your conversation

Enter your prompt in the chat interface. Use files (click "+ Add file") to enhance results with current information. Upload images (click + sign) to include additional context in your conversation anytime. See example below: 

<figure><img src="/files/0cFvtgHUMiwHpfjBai8K" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### &#x20;Sharing

Projects can be shared with teams or users.

* **View access** – others can see and use the Project without changes
* **Edit access** – collaborators can update files, settings, and structure

This makes Projects a shared workspace, so everyone works from the same context.

### Video walk-through

{% embed url="<https://youtu.be/XuWOLnr7MfE>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexos.ai/workspace/projects.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.