hermes - 💡(How to fix) Fix [Feature]: Refactor project into standard Python package structure

Problem or Use Case

Description:

Currently, the codebase is not organized as a proper Python package. Key components like AIAgent are placed in top-level scripts such as run_agent.py. After pip install, users are forced to import from run_agent directly, which is unconventional and confusing.

Proposed change

Restructure the source tree into a standard package layout so that the project can be imported using a clean namespace, e.g.:

import hermes_agent.AIAgent
or
import hermes.AIAgent

instead of the current:

import run_agent

Benefits

Follows Python packaging best practices.

Provides a clear, intuitive import path for users.

Enables better IDE support (autocompletion, type checking).

Makes the codebase more maintainable and extensible.

The internal implementation and public APIs should remain functionally identical — only the import paths change.

Proposed Solution

it's better to use one command line to install hermes-agent and one package to import, for example

pip install hermes-agent

import hermes

hermes.AIAgent()

Alternatives Considered

No response

Feature Type

Developer experience (tests, docs, CI)

Scope

None

Contribution

• I'd like to implement this myself and submit a PR

Debug Report (optional)